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ABSTRACT 



SACS is a cache simulator that provides the user with a wide range of timing 
information, in addition to providing typical information such as hit and miss rates. The 
SACS model includes read and write buffers, main memory, and cache memory. In 
addition, SACS supports a number of buffer and data forwarding policies, as well as the 
traditional block replacement, write, and write miss policies. SACS also includes a 
self-testing mode which can be used to debug the program after source-code modification. 
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1. INTRODUCTION 



A. CACHE MEMORIES 

Cache memories are usually small memories that contain blocks of data and/or 
instructions [Ref 1 ]. Each block is a copy of consecutive data and/or instruction bytes 
from main memory. Caches are usually much faster than their main memory counter parts. 
They are, in effect, short term memory. The cache contains a set of blocks recently 
accessed by the CPU. The cache can provide the most recently used data and/or 
instructions to the CPU in less time than it would have taken to get the information from 
main memory. However, if the cache fails to provide the information, then it fetches the 
information from main memory and, depending on its design, may choose to enter the 
information into the cache. The cache also performs memory updates in the form of writes. 
Memory updates can occur when the CPU makes a write request, or the cache can store 
new data in the cache blocks and wait until later to write the data to memory [Ref. 2:p. 197 
]. A dirty block is a cache block which contains data that is more current than memory 
because of a recent write request. 

The concept of the cache storing recently used memory blocks is very simple. In 
fact, many early cache designs were simple implementations of the concept. However, the 
task of building an optimized cache is not trivial. The difficulty comes from trying to 
provide the CPU with the correct data or instruction as soon as it is available. For example. 



if a block read is in progress and there is enough data available to satisfy the pending load, 
the data should be forwarded to the CPU rather than waiting for the block read and cache 
update. The cache often performs block management between requests. One example of 
block management is writing dirty data to memory. Another example is reading data that 
was not part of the CPU request, but located in the same block. This allows the cache to 
contain all the data that was in the block An optimized cache performs block management 
only after completing the CPU request. Complications arise when the CPU makes another 
request before the block management for the last request is complete. If this happens, the 
cache has to search for data in the control sections of the cache as well as the cache 
memory. 

More and more cache designs incorporate read and write buffers in their control 
sections. These buffers allow the cache to perform block management while minimizing 
the effect on the CPU request [Ref 3], For example, if a CPU read request results in a 
miss and the block victim has a dirty sub block, then writing the dirty sub block to memory 
may occur after reading the replacement block. This allows the cache to forward the read 
data to the CPU before writing the old data to memory. Figure 1 provides a simplified data 
flow diagram that illustrates buffer use in modem cache designs 

Scoreboarding is a term that has been used to describe the process of searching, and 
choosing the correct value of a register argument. Scoreboarding in a cache represents the 
act of searching and altering buffers based on new CPU requests. One example of 
scoreboarding is searching a buffer for CPU requested data. Searching block and write 
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buffers may provide data that is not available in the cache memory. Searching the read 
buffer ensures that no duplicate read requests are placed in the buffer. However, it will not 
provide any new data. Another example of scoreboarding is updating read requests in the 
read buffer with data provided by CPU write requests. 

B. PROBLEMS OF CACHE MEMORIES 

Cache memories can cause more problems than they solve and they can 
significantly complicate the memory model. The most obvious problem with a cache 
memory is that it does not always contain the data that the CPU requests. This is defined 
as a read miss. A write miss is when the CPU makes a write request and the correct block 
is not in the cache. Conversely, a read hit is when the data is available, and a write hit is 
when the block is available. There are three types of cache misses [Ref. 4:p. 419] First, 
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the compulsory miss results when data is accessed for the first time. Second, the capacity 
miss, occurs when the cache is not big enough to carry all the blocks required. The third 
type, collision misses, occurs when the cache requires several main memory blocks that 
map to the same set of cache blocks. This causes a form of thrashing similar to that seen in 
virtual memories. 

In some numerical calculations, the cache makes the average access time greater 
than the main memory access and transfer times. This is often due to matrix operations that 
access elements across rows and force the cache to enter an entire block of data for each 
element read Depending on the size of the matrix, it may not be possible to save enough 
blocks to ensure that the next block accessed was not selected as a victim and replaced. As 
a result, many architectures support special load and store instructions that bypass the 
cache. 

C. EXISTING CACHE SIMULATORS 

There are a number of cache simulators. Two examples include Dinero III, and 
Tyco [Ref. 5], Dinero III provides hit and miss data for a wide range of input arguments. 
Dinero III will also simulate either a unified cache, or separate data and instruction caches 
Tyco, on the other hand, simulates several different cache options simultaneously for 
comparison 

D. PROBLEMS WITH EXISTING CACHE SIMULATORS 

Unfortunately, both Dinero HI and Tyco limit their simulations to hit-miss 
calculations. With nothing but hit-miss information, the designer cannot optimize his cache 
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for the lowest average access time. Most caches are designed to have low average access 
times rather than high hit rates [Ref. 4:p. 405]. Since Dinero III and Tyco do not perform 
any timing analysis, they may mislead the designer. Dinero Eli and Tyco also do not 
provide any buffer simulations because they assume that the cache has all the time it needs 
between loads and stores to complete all of its block management. Since buffer 
management and scoreboarding have such a large effect on the average access time, there 
is an obvious need for a simulator that can perform accurate timing analysis, buffer 
management, and scoreboarding. 
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II. INTRODUCTION TO SACS 



A. THE NEED FOR STILL ANOTHER CACHE SIMULATOR 

A cache simulator should not only simulate the cache memory, it should simulate 
main memory and any buffers it uses. As discussed earlier, neither Dinero III nor Tyco 
provide any means for simulating buffers or memory. 

Without timing analysis, the designer is unable to determine the effect of 
scoreboarding protocols. These protocols, which are usually very difficult to implement, 
can be avoided by delaying any read requests until all writes are completed and the last 
read block has been entered into the cache. Timing analysis allows the designer to choose 
the scoreboarding technique that best suites his or her resources and architectural 
requirements. A hit-miss cache simulator reduces this process to guess work. 

B. COMPARING SACS TO OTHER CACHE SIMULATORS 

As previously discussed, other cache simulators provide hit-miss results, while 
SACS provides the all important average access time. However, in addition to the correct 
performance measurements, a simulator should illustrate a cache's strengths and 
weaknesses. It should give the user a clear understanding of how to improve the cache's 
design. With Dinero III, the user could only guess on how to improve his/her cache design. 
Tyco attempted to correct this problem by allowing the user to simulate several caches 
simultaneously However, given the number of different variables and policy choices. 
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exhausting all possible combinations is not the best way to design a cache. SACS is unique 
because it provides the user with a detailed analysis of exactly what the cache was doing 
during a simulation run. The user can then identify and correct specific problems with a 
cache design. 

C. THE CAPABILITIES OF SACS 

SACS allows the designer to experiment with different policies while measuring 
their affect on the average access time. SACS provides the user with more detailed 
information because it maintains a log of how every clock cycle is spent. This log is kept in 
the form of a histogram. It allows the user to see exactly how much time is spent 
performing read or write requests. It also records how many times a request was 
completed within a given time period. With these details, the user can easily evaluate the 
cache's performance. A second histogram is available which details the amount of time 
spent performing cache accesses, memory accesses, and waiting for full buffers. With this 
histogram, the designer can target specific weaknesses. It also provides a good comparison 
of the effect of different scoreboarding policies between runs. 
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III. SACS INPUT PARAMETERS 



A. INTRODUCTION 

SACS provides a wide range of input parameters to model various different 
functionally diverse caches. While it is impossible to imagine what kinds of caches 
designers might build in the future, every effort was made to allow the designer to simulate, 
or most nearly approximate, his or her design Table 1 lists arguments that SACS 
supports. 



TABLE 1. 

SACS INPUT ARGUMENTS 


Cache Size (-cs n) 


Read Forward (-rf -drf) 


Blocks Size (-bs n) 


CPU Waits For Cache Writes (-ewfew -dewfew) 


Sub Block Size (-sbs n) 


Search Block Buffer (-sbb, - dsbb ) 


Associativity (-a n) 


Update Read Buffer (-urb f -durb) 


Word Size (-ws n) 


Remove Read Duplicates (-rrd y - drrd ) 


Read Cache Access Time (-rcat n) 


Remove Write Duplicates (- rwd , -drwd) 


Read Cache Hit Time (-rcht n) 


Read Priority (-rpr n) 


Read Cache Miss Time (-rcmt n) 


Write Priority (- wpr n) 


Write Cache Access Time (-n eat n) 


Read For Write Allocate Priority (-rfwapr n) 


Write Cache Hit Time (-wcht n) 


Write Dirty Block Priority (-wdhpr n) 


Write Cache Miss Time (-wemt n) 


No Priority (-npr n) 


Memory Access Time (-mat n) 


Trace (-t, -dt) 


Memory Transfer Time (-mtt n) 


Check (-c\ -dc) 


Buffer Cache Access Time (-beat n) 


Test (-test) 


Read Buffer Size (-rbs n) 


Key Board I() (-kbio, - fio) 


Write Buffer Size (-wbs n) 


Data File Name (-f "File Name") 


Block Replacement Policy (-brp el) 


Screen Histogram Max Index (-shmi n) 


Write Policy (-wp e2) 

Write Miss Policy (-wmp e3) 


File Histogram Max Index (-fhmi n) 



n Unsigned Integer 

el enumeration type (LRU. FIFO. RANU) 
c2 enumeration type ( Write Through Wnte Back) 
e> enumeration type (Write Around. Wnte Allocate) 
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B. 



SIZE ARGUMENTS 



All sizes are entered in bytes. Cache Size must be an even multiple of both Block 
Size and Associativity. Block size must be an even multiple of Sub Block Size , and Sub 
Block Size must be an even multiple of Word Size. Word Size may be any positive integer 
that does not force an integer overflow in Cache Size or Block Size. 

C. CACHE ACCESS, HIT, AND MISS ARGUMENTS 

Cache Access Times represent the time required for a request to access the cache, 
providing the cache is not busy. At the end of this time it is determined whether the request 
is a hit or a miss. The Cache Hit Time represents the time required to complete a request 
once the cache access time has expired and the request has been identified as a hit. If the 
request was a miss, then the Cache Miss 'Time is used instead. 

D. MEMORY ACCESS AND TRANSFER TIME ARGUMENTS 

The Memory’ Access Time is the time required for a buffer to access, and then 
transfer, the first word of a request from memory Memory' Transfer Time is the time 
required for a buffer to transfer each consecutive word following the first access. 

E. BUFFER ARGUMENTS 

After a memory read, the Block Buffer contains the new data that must be entered 
into the cache. The time that the Block Buffer takes to access the cache is called the Buffer 
Cache Access Time. The Block Buffer may have to wait longer because the cache is busy. 
The buffer cache access will not occur if a read or write cache access is required during the 
same clock cycle. However, once the access begins, the read and write cache accesses are 
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locked out until the cache is updated The Read and Write Buffer sizes can be any positive 
non zero integer (<100). 

F. CACHE POLICY ARGUMENTS 

Block replacement policy determines the method used to choose the location of a 
new block in the cache. SACS supports three block replacement policies: Least Recently 
Used (LRU), First In First Out (FIFO), and Random (RAND). There are two write 
policies: Write Through, and Write Back. The Write Through policy forwards the data to 
memory immediately after a write request. However, in the Write Back policy, the data is 
saved in the cache until the block that contained the data is selected as a victim. Dirty bits 
indicate which sub blocks have new data that must be written to main memory. 

SACS can easily be modified to support new write, or write miss policies by adding 
the new policy name to Write Policy Types , or the Write Miss Policy Types in SACS.h. 

The code to simulate these new policies must be placed in the procedures Write Hit, and/or 
Write Miss which are both located in Cache, c New block replacement policies may also 
be added by modifying Replacement Policy Types in SACS.h, and Select Block Victim in 
( 'ache, c. 

If CPU Waits For Cache Writes is asserted the CPU will wait after a write request 
until the cache is complete with the write. Otherwise, it is assumed that the cache can carry 
out the write while the CPU continues with other instructions. 

If Read Forward is asserted, then a read miss is complete once the data required 
arrives in the block buffer. Otherwise, the read must wait until the block updates the cache. 
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G. SEARCH BUFFERS AND UPDATE BUFFER ARGUMENTS 

Search Block Buffer allows the cache to search the block buffer in case the read 
data was already received from memory If any part of the data is found in the buffer, then 
the size of the request will be appropriately reduced l Ipdate Read Buffer allows a write 
memory request to provide data required by a read request If any read request needs the 
data provided by the write memory request, then the size of the read request will be 
reduced appropriately, and the data is not read from memory. 

H. REMOVE READ DUPLICATES AND WRITE DUPLICATES 

ARGUMENTS 

Removing read and write duplicates means that requests that have intersecting or 
concurrent data will get spliced together into one request Otherwise, a buffer may contain 
multiple requests to the same memory location. 

I. PRIORITY ARGUMENTS 

In SACS, the user specifies the priority of requests. The lowest numbers represent 
the highest priority. This allows the designer to simulate a cache that must finish all writes 
before starting a read. It also allows the designer to delay reads for write allocated blocks, 
and the writing of dirty blocks. 

.1. SACS CONTROL ARGUMENTS 

1. Introduction 

SACS has control arguments that allow the user to select one of several 



modes of operation. 
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Trace Argument 



The trace mode permits the user to step through a trace, one clock cycle at a 
time, viewing the contents of the cache and buffers, and obtain statistical results. 

3. Check Argument 

When SACS is in the check mode, it performs a self check of all of its 
global variables. These checks include checking to see that all the global variables that 
should remain constant, do in fact remain constant. Global variables that are not constant 
are checked to see that they are within prescribed bounds. This form of checking can occur 
while the program is in any other mode (i.e.. Trace, Test, or Key Board I/O) This check 
can be performed during normal data runs. This kind of checking helps to identify errors 
that might have gone unnoticed. It also assures the user that the program did not 
catastrophically fail during a run 

4. Test Argument 

When SACS is in its test mode it can do nothing else. It will automatically 
generate its own input data. The data is generated by randomly selecting a finite number of 
test cases to use. Each test case has a combination of seven load/store instructions The 
expected number of read and write hits for each test case is known. Therefore, the total 
number of read and write hits for the trace can be determined The actual addresses used 
for each test case are chosen randomly. However, all the loads for a particular test case 
will map to the same block. Similarly, all stores will also map to the same block SACS 
will randomly select its own set of input parameters, ignoring any other arguments entered. 
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It will then run the main routine on the test trace as if it was a user defined file. Once the 



trace is complete, SACS will compare the results with what it expected from the random 
trace. If no errors have been detected, then SACS will repeat the process of randomly 
generating its input file and input parameters. The test mode places SACS into an infinite 
testing loop. The only way to terminate the process is to kill the process. The decision not 
to give the user a more graceful way out of the test mode was made because C does not 
provide a way to trap 10 While there are operating system methods of trapping 10, they 
would have made the program system dependent and, therefore, non-portable. The current 
version of SACS has been compiled and run on both a PC running DOS and a SPARC 
station running Sun -OS without any changes to the source code. 

5. Key Board IO Argument 

SACS normally accepts its inputs from a data file. However, it can accept 
inputs directly from the user. This input mode can be used with the trace and checking 
modes if desired SACS will ask for each request from the terminal as required. The trace 
display will appear each time a new request is made. However, it will not stop every clock 
cycle unless the user selects the trace mode 

6. Data File Name Argument 

SACS normally assumes that the data file is named "SACS.Dat", however 
the user can specify the name of the file he or she wishes to trace using the data file name 
argument. 
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7. 



Histogram Max. Index Arguments 



SACS provides the user with two timing histograms. One provides timing 
analysis for read and write requests. The first histogram illustrates how many requests 
were completed during the designated time. The second histogram provides timing 
analysis for the number of times the cache waited to complete a particular task in the 
designated time. The maximum index for these histograms is the maximum number of 
time bins Since there may be data out of the maximum index range, the last bin is used to 
total all events with times greater than or equal to the maximum index. The screen 
histogram maximum index is the number used for screen displays. The screen maximum 
histogram index has a default value of 4, which allows all displays to fit on a standard 80 
column screen. However, if a Unix window is available, the designer may want to raise 
this number to get more detailed displays. The file histogram maximum index is used for 
the output file generated by SACS. This file may have a much larger range because it does 
not have to be printed on a screen The output file is compatible with MATLAB script 
files. This allows results to be read and processed by MATLAB for statistical analysis and 
plotting purposes. 



14 



IV. SACS DISPLAYS 



A. TRACE DISPLAY 
I. Introduction 

SACS includes a trace mode that allows users to monitor the behavior of the 
simulated cache and the implemented policies and scoreboarding techniques. The user 
may also need to debug any modifications made to SACS The trace mode is also very 
useful in identifying any programming errors. The trace mode allows the designer to 
review the status of the cache at the end of each clock cycle. A trace display is shown in 
Figure 2. 
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Figure 2 Trace Display 
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2 . 



Current Request Fields 



The trace display contains the last CPU request, as well as the request 
address and size. SACS can only process requests that are contained within the same 
block. If a request spans across two or more blocks, then the request is split up into block 
size requests and processed separately. 

3. Cache Waiting For Field 

Whatever is holding up the last CPU request is shown in the Cache Waiting 
For field. In Table 2, we can see all the things that the cache might have to wait for. If the 
cache is waiting for nothing, then the request has been satisfied. If the cache is waiting for 
a read or write cache request, then the cache is being accessed. If the cache is waiting for a 
memory request, then some part of the request must be retrieved from memory and the 
data is not available. If the request can not proceed because one of the buffers is full, then 
C ache Waiting For will indicate whether the request is waiting for the full read buffer or 
the full write buffer Note that a read miss request may have to wait for dirty blocks to be 
written to memory, making it possible for a read request to wait on a full write buffer. 

4. Memory Waiting For Field 

Manor y Waiting For identifies which memory function is in progress. 

When a new memory access begins, Menton > Waiting For indicates whether it is a memory 
read request or a memory write request Once the access of the first word is in progress, 
then Memory Waiting For will indicate either read access or write access. However, once 
the first word has been received, then Memory Waiting For will switch to indicate either a 
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read transfer or a write transfer If a memory read request needs to begin and the block 
buffer is busy because it has not updated the cache from the last request, then Memory 
Waiting For will indicate cache update. 

5. Block Waiting For Field 

Block Waiting For describes what the block buffer is doing. It will indicate 
memory block transfer when a memory read access or transfer is in progress. However, 
once the transfer is complete, the block buffer must update the cache. If the cache is busy, 
then Block Wailing For will indicate that it's waiting for cache access. When the cache is 
not busy and the cache update begins, then Block Waiting For will switch to indicate block 
cache transfer. 



TABLE 2. 

WAIT FOR CONDITIONS 


Cache 

Wait For Conditions 


Memory 

Wait For Conditions 


Block Buffer 
Wait For Conditions 


Nothing 

Read Cache Request 
Read Memory Request 
Write Cache Request 
Write Memory Request 
Full Read Buffer 
Full Write Buffer 
CPU Cache Access 


Nothing 

Memory Read Request 
Memory Read Transfer 
Memory Write Request 
Memory Write Access 
Memory Write Transfer 
Cache Update 


Nothing 

Memory Block Transfer 
Block Cache Access 
Block Cache Transfer 



6. Timing Data Fields 

The trace display shown in Figure 2 includes a time field that indicates how 
many clock cycles have passed since the start of the run. The Next Request Time is the 
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time at which the CPU either has, or will make, another request. The TO A field indicates 



when the next memory word will arrive into the Block Buffer. However, if a write was in 
progress, this field would be a TOD field, and would indicate the time that the next word 
will leave the Write Buffer. 

7. Cache Hit and Buffer Hit Fields 

The cache hit field indicates whether a request is a hit or not. The buffer hit 
for a read request indicates whether the data requested is in the Block Buffer A buffer hit 
for a write request indicates that the Write Buffer needed to write the data to memory 
anyway. A buffer hit will only occur during a cache miss. Buffer hits allow the designer to 
determine how many times the scoreboarding was used during a run to avoid a memory 
access. However, the true measurement of a cache's performance is its average access 
time 

8. Address Block Selection Display 

During a trace run it is helpful to see the cache set that the request address 
got mapped to. This includes all the blocks that the cache had to work with to satisfy the 
request If the request is a hit, the block that it hit on has to be in this set. If a block victim 
is chosen, it has to be chosen from this set. 

9. Buffer Displays 

The contents of all the buffers are displayed so that the designer may see 
what the memory is working on The Request Size is the number of bytes that have to be 
read in order for the current request to have all the data originally asked for. This number 
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might be reduced from the original request size if part of the data is in the cache or if Block 
Buffer is allowed to contribute data to the request. During the trace, the address, size, and 
request size will constantly change as CPU requests, and memory accesses and transfers, 
are made. The block field indicates which cache block the read data will be placed in. The 
priority field indicates the priority of the memory request A zero priority indicates that the 
request is in progress. The next lowest number will be serviced next, unless a new 
memory request is made. If more than one request has the same priority number, then the 
read buffer will take priority. If the read buffer has more than one request with the same 
priority, then the priority will switch to FIFO 

10. Time Required and Completion Time Fields 

Every memory request has a Time Required to complete and a Completion 
Time. The Time Required to complete is the time that memory will have to service the 
request. The Completion Time is the time that the request is expected to be removed from 
the buffer. 

1 1. Next Command Please 

The next command line includes a prompt for the user of all the available 
commands. Shown in Table 3 is a list of all the commands. In the following paragraphs, 
these commands are discussed in detail. 
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TABLE 3. 

TRACE COMMANDS 



Trace Display (T) 
Results Display (R) 

Stall Timing Display (S) 
Cache Arguments Display ( C) 
Go To A Specific Time (G #) 
Increment Time (#) 
Decrement Time (-#) 
Help (H) 



B. RESULTS DISPLAY 

The Results Display , shown in Figure 2, provides the user with the number of 
requests, cache hits, and buffer hits. The hit rates are a combination of both the cache hits 
and the buffer hits. The Request Time Histogram gives the number of requests that were 
completed in the prescribed time. The total amount of time spent on each request, and the 
average access times, are also displayed. As discussed previously, the average access time 
is the ultimate measure of cache performance. 
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Requests Break Down 



Number Number Number 
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1 
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Histogram. 




Ave 

Access 




Time=00 


Time=01 
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11 
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4 
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0 0 
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0 
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Next Command Please [ T, R, S, C, G # , #, -# , Help] »>Q 

Figure 3 Results Display 



C. STALL DISPLAY 



The stall display provides the designer with an exact account of where the cache 



spent all its time As shown in Figure 4, the stall time histogram lists all the events that the 



cache has ever waited for, and the number of times that the cache waited for an event 



within a designated period. 
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Figure 4 Stall Timing Display 
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D. CACHE ARGUMENTS DISPLAY 

The cache arguments display allows the user to review the arguments used by the 
simulator. Figure 5 shows an example of the cache arguments display. 





Cache Arguments List 




Cache Size: 


00008192 


Read Forward: 


Yes 


Block Size: 


00016 


CPU Waits For Cache Writes : 


No 


Sub Block Size: 


00004 


Search Block Buffer: 


Yes 


Associativity: 


04 


Update Read Buffer: 


Yes 


Word Size: 


00004 


Remove Read Duplicates : 


No 


Read Cache Acccess Time: 


0 


Remove Write Duplicates : 


No 


Read Cache Hit Time : 


0 


Read Priority: 


10 


Read Cache Miss Time: 


0 


Write Priority: 


11 


Write Cache Access Time: 


1 


Read For Write Allocate: 


12 


Write Cache Hit Time : 


1 


Write Dirty Block Priority: 


13 


Write Cache Miss Time : 


0 


No Priority: 


100 


Memory Access Time : 


3 


Trace: 


Yes 


Memory Transfer Time: 


1 


Check : 


Yes 


Buffer Cache Access Time: 


: 1 


Test: 


No 


Read Buffer Size: 


04 


Key Board 10: 


No 


Write Buffer Size: 


04 


Data File Name: 


SACS . Dat 


Block Replacement Policy: 


; LRU 


Screen History Max Index: 


0004 


Write Policy: 


Write Through 


File History Max Index: 


0010 


Write Miss Policy: 


Write Allocate 






Next Command Please [ T, 


R, S, C, G #, # 


, Help] »>□ 




Figure 5 Cache Arguments Display 





E. GO TO A SPECIFIC TIME 

Because data traces are usually very long, SACS was given the ability to run to a 
specific time This allows the user to begin a long trace and inspect the results after a 
reasonable amount of time If the user is debugging SACS because of a modification or, 
God forbid, there is an original error in SACS, this command will allow the user to advance 
to the last time the error occurred. If the time specified is earlier than the current time, then 
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SACS will temporally turn off the trace, restart the run from the beginning, and stop at the 
desired time. Once SACS is at the desired time, it will turn the trace mode back on To the 
user, it will appear that SACS went backwards. However, in fact, SACS can not run its 
simulations in reverse. Obviously, if the Desired Time is vary large, then this process 
could take a great deal of time. 

F. INCREMENT TIME 

Increment time allows the user to adjust the time using a relative step size instead 
of an absolute desired time. 

G. DECREMENT TIME 

Decrement time allows the user to adjust the time using a relative step size instead 
of an absolute desired time. Again, SACS must restart the run from the beginning to stop 
at the desired time. 

H. HELP DISPLAY 

The help menu, shown in Figure 5, gives the user simple descriptions of what all 
the trace commands can do. 
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Help Menu 

[T] Trace Display: 

Displays current request, status of memory, and contents 
of buffers . 

[R] Results Display 

Displays a break down of read and write cache hits , and 
buffer hits, including a timing analysis . 

[S] Stall Timing Display: 

Displays histogram of the time spent on each stall. 
Stalls represent time delays in completing a request. 

[C] Cache Arguments Display: 

Display input arguments to SACS . 

[G] Go: Go to end of run. 

[G #] Go To: Go to Time #. 

[#] Step: Increment Time By #. 

[-#] Back Step: Decrement Time By #. 

[H] Help: Displays this help menu. 

Next Command Please [T. R, S, C, G #, #, -# , Help] >»□ 



Figure 5 Help Display 
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V. SACS DESIGN 



A. OVERALL STRUCTURE OF SACS 

SACS simulates all events one clock cycle at a time using a global variable named 
Time. Normally, it is preferable to perform timing simulations using event queues so that 
time can advance to the next event However, in most cache simulations, so many events 
happen in one clock cycle that an event queue would probably not improve the performance 
of the simulator. 

B. MAIN EVENT LOOP 

In the main event loop of SACS, Time is incremented one clock cycle at a time. 

Time is never changed by any other procedure. The requests are entered into the 
simulation from Get Next Request. Simulation of all events is performed by the Main 
Event Loop calling Cache Model , Memory Model, and Update Cache. 

SACS insures that all events that can be started during a particular clock cycle are 
started, and that all events that can complete during a particular clock cycle do CPU 
accesses to the cache are given priority over the block buffer cache updates 

SACS's main loop includes the source code to control testing, checking, and 
tracing. The Desired Time variable is controlled entirely by the Main Event Loop. Desired 
Time represents a user request to advance the simulation to a particular time with the trace 
off. SACS can not run Time backwards However, if the Desired Time is less than Time, 
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then Time is reset back to zero and the run is repeated up to the Desired Time. The user 
can make time requests using arguments M G or 

Throughout Main Event Loop , Cache Waiting For is checked to see if it's equal to 
Nothing This indicates that the last request has been serviced and that the cache is ready 
for the next request. The procedures that model specific events as Read Hit , Read Miss, 
and Access Cache are called repeatedly during their simulations. They utilize Cache 
Waiting For and Time to determine what to do next. If any of these procedures need to 
wait for a period, either to simulate an access or because a resource is not available, then 
they will set Cache Waiting For to the appropriate value. The modeling procedures in 
Memory Mode! work the same way using Memory > Waiting For. 

Whenever SACS finds an error or a discrepancy then the boolean variable 
Discrepancy Found is set to Yes. This forces SACS into a trace mode so that the user may 
try to identify the cause of the error. In test mode, a discrepancy forces SACS out of test 
mode so that the trace file that caused the error is not erased by a new file. 

C. CACHE MODEL 

('ache Mode! makes all the necessary calls to simulate cache memory Cache 
Mode! decides which calls to make based on the values of Cache Hit and Request. This 
function is called every time Time is incremented If there are no read or write requests 
waiting to be completed, the function does nothing. The value of Cache HU will remain 
Unknown until the appropriate cache access time has expired. Then, Cache Mode! will call 
Is Request A Hit to determine if the request is a hit or a miss 
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1. Is Request A Hit 

Is Request A Hit determines if the request is a hit or a miss, and sets Cache 
Hit to the appropriate value. Is Request A Hit will find the Set Number that the data is 
supposed to be in. Then, all Cache Block Addresses in that set will be checked to see if 
they equal the Block Address for that request. If the correct block is found, then all sub 
blocks that are required to satisfy the request will be inspected for validity. If they are valid 
then Cache Hit will equal Yes. 

2. Read Hit 

Read Hit is called to simulate a cache hit during a read request. Read Hit 
simply finishes simulating the cache access for the hit. Read Cache Hit Time is the time 
required to send the data from the cache to the CPU. Note that the time to locate the block 
in the cache is simulated in Cache Model Read Hit is called repeatedly while Time is 
incremented until Access Cache returns with Cache Waiting For equal to Nothing. Access 
Cache will return Cache Waiting For equal to Read Cache Request until the Read Cache 
Hit Time has expired. 

3. Read Miss 

Read Miss is called to simulate a cache miss during a read request Read 
Miss first simulates the time it would take to perform all the block management for a read 
miss. This time is called Read Cache Miss Time. Once that time has expired. Read Miss 
will call Select Block Victim to pick a block in the set. When Select Block Victim returns 
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with Cache Waiting For equal to Nothing the Request Block Number will contain the new 
block number where the data will be placed 

Once the new block has been chosen. Read Miss will call Add To Read 
Buffer. If Read Forward is selected, then Required Size for the memory request will be 
equal to the Request Size. However, if it is not, then Required Size for the memory request 
will equal Block Size. The Required Size in read memory request tells the Memory Model 
how much of the requested data must be read into the Block Buffer before resetting Cache 
Waiting For back to Nothing. By setting Required Size equal to Block Size , Read Miss is 
forcing Memory Model to read in the entire block before setting ('ache Waiting For back to 
Nothing. Once the Memory Model has received the data, it is assumed to be available to 
the CPU during that clock cycle. 

4. Write Hit 

Write Hit is called to simulate a cache hit during a write request. Write Hit 
will first simulate the time to write the data to the Request Block Number in the cache. The 
time to locate the block was simulated by Cache Model Once Write ('ache Hit Time has 
expired then Write Hit will perform the block management for the request. The block 
management is dictated by the Write Policy. For a Write Back policy, the sub blocks 
written to must have their dirty bits set This is done by Set Dirty Bit. For a Write 
Through policy, the memory request must be entered into the write buffer. This is done by 
Add To Write Buffer 



28 



5 . 



Write Miss 



Write Miss is called to simulate a cache miss during a write request. Write 
Miss will first simulate the time needed to make all memory requests. This time is called 
Write Cache Miss Time This is only the time required to make the requests, not the time 
required to complete them. The time to determine that the correct block was not in the 
cache memory was simulated by Cache Model. The memory requests are entered into the 
buffers after the Write Cache Miss Time expires. The memory requests are dictated by the 
Write Miss Policy. The simplest policy is Write Around. For a Write Around policy, the 
write data is placed in the Write Buffer by Add To Write Buffer. Write Allocate, however, 
is the toughest simulation in SACS. Write Miss must first choose a block to put the new 
data in. This is done by Select Block Victim. Block data not provided by the write request 
has to be read in. This read request is made by Add To Read Buffer. The read address is 
calculated by adding the request size to the address. Because new address may be in the 
next block, the Block Size may have to be subtracted to make the addition modulo. Sub 
blocks that were written to in there entirety will have there valid bits set to reflect the 
presence of the data provided by the CPU. However, if only part of a sub block was 
written to, then the ('ache Valid Bit will not be set. 

Write Miss uses the Write Policy to dictate how the write data is to update 
the memory. For a Write Back policy, dirty bits are set by Set Dirty Bits. For a Write 
Through, the data is added to the Write Buffer by Add To Write Buffer. 
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6 . 



Access Cache 



Access Cache is called to simulate the CPU accessing the cache. Access 
Cache first waits for the cache not to be busy. The only reason it could be busy is if the 
Block Buffer is in the process of updating the cache. During this time. Access Cache will 
return Cache Waiting For equal to CPU Cache Access. Once the cache is not busy then 
Cache Busy is set to Yes. locking out the Block Buffer from accessing the cache. Then, 
Cache Waiting For will be set equal to Waiting For Request. This is a local variable 
passed by the caller. It will either be equal to Read Cache Access or Write Cache Access. 
Then, Cache Busy is set for the time specified by Request Time. Request Time is a local 
variable. It could equal any of the hit, miss, or access times. Once Request Time has 
expired then Access Cache will set Cache Busy equal to No, and Cache Waiting For equal 
to Nothing. 

7. Select Block Victim 

Select Block Victim chooses the next block to be used and writes the dirty 
sub blocks out to the Write Buffer. Select Block Victim first surveys the cache set that the 
Request Address maps to The survey includes finding the block that was least recently 
accessed This Block Number is stored in LRUBIock. Once the set has been surveyed then 
the Replacement Policy dictates how the block is chosen. For the LRU policy. Request 
Block Number is set equal to LRUBIock. For the FIFO policy. Cache Next Block keeps 
track of the next victim block for each set. Cache Next Block is initialized to all zeros 
during the beginning of a run Therefore, it must be checked to see if it is between the first 



30 



and last blocks for the set. If it is not, then Cache Next Block for Set Number is reset to 



First Block. Once Select Block Victim knows it has a valid Cache Next Block then Request 
Block is set equal to it. Then, Cache Next Block for the Set Number is incremented. For 
RAND policy, the block number is chosen randomly from all the blocks in the set 

Select Block Victim writes all dirty sub blocks to the write buffer using Write Dirty 
Sub Blocks. Write Dirty Sub Blocks takes care of clearing the dirty and valid bits in the 
block. Once Select Block Victim is called and it gets to the bottom of the function with 
Cache Waiting For equal to Nothing, then the Cache Block Address for the Request Block 
Number is set equal to the block address of Request Address. 

8. Set Dirty Bits 

Set Dirty Bits sets the dirty bits for all sub blocks that contain data that was 
modified by a write request. 

9. Write Dirty Sub Blocks 

Write Dirt y Sub Blocks is called to simulate writing all the dirty sub blocks 
in the Request Block. Write Dirty Sub Blocks not only clears all the dirty bits, it also clears 
all the valid bits Write Dirty Sub Blocks prepares a block to receive new data, and is 
called after a block has been selected as a victim Write Dirty > Sub Blocks will search the 
block for consecutive dirty blocks and splice them together into one write request The 
write request is then added to the Write Buffer. All of the sub blocks that make up the 
request will have their dirty and valid bits cleared This process of searching and writing is 
repeated until all the bits are not dirty. Then, all the valid bits are cleared. 
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10. Add To Read Buffer 



Add To Read Buffer takes the elements of a request and adds the request to 
the Read Buffer. It will perform all of the searches and updates necessary to support the 
appropriate scoreboarding protocols. 

Add To Read Buffer will begin by searching the cache and Block Buffer for 
each byte in the request, starting at the beginning of the request. Every time a byte is found 
in one or the other, the Address is incremented while Size and Required Size are 
decremented. This simulates removing the available data from the front of the request. 
Then, Add To Read Buffer will search the cache and Block Buffer for the data at the end of 
the request. Every time a byte is found, the Size of the request is decremented by one. If 
the byte was a required byte then the Required Size is also decremented. This simulates 
removing any data available from the end of the request. Add To Read Buffer is either left 
with a request that has a Size equal to zero or the end points are both needed from memory. 
If the Required Size is zero then the request is a buffer hit, otherwise the request is a buffer 
miss. If the request is already a cache hit then the buffer hit is for some block management 
request. These kinds of buffer hits are not recorded because it would confuse the Results 
Display by making it possible to get a hit rate greater than 100%. If the Size is not zero 
and Remove Read Duplicates is equal to No then the request is added to the end of the 
Read Buffer using Append. Append is a buffer utility that adds the request to the end of the 
buffer. The request must be added to the end of the buffer in order not to interfere with 
Memory Mode I. which may be in the middle of a memory read If Remove Read 
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Duplicates is equal to Yes then the first byte in the request will be spliced into the Read 
Buffer. 

Splice is another buffer utility. Splice will first search the Read Buffer for the byte. 
If it can't find a request in the buffer that contaias the byte then it will search for a memory 
request that is getting data from the same block If one is found then the request is 
modified to include the new read byte request. If no suitable request can be found then 
Splice will add a one byte request to the Read Buffer The Address is then incremented 
while Size and Required Size are decremented. Then, the cache and Block Buffer are 
searched for the next byte If it is not found then the next byte is spliced into the Read 
Buffer. This process is repeated until all of the bytes of the request have either been spliced 
into the Read Buffer or found. 

The Buffer Hit is normally defined as when the data is available but not in the 
cache. However, in order to support the testing of SACS, the definition of a buffer hit is 
revised to mean that a request was found to have accrued recently, and that given time to 
complete all block management requested data would have been in the cache. This allows 
Test SACS to predict the hits of a test run without taking into account the time it takes to 
perform the block management. 

Every time a request is spliced into the read or write buffers, the Time To Execute 
and Completion Time Estimate must be recalculated The new time estimates are 
performed by Calculate Time Estimates. 
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11. Search Cache 



Search Cache is called by Add To Read Buffer to find any parts of the 
request that may already be located in the cache. This must be done because if a read 
request follows a write request using a write allocate policy, then part of the read may be in 
the cache while the rest may still need to be read from memory Search Cache checks all 
Cache Block Addresses in the cache set. If any of the cache block addresses equal the 
block address of the byte, then Search Cache checks the Cache Valid Bit for the sub block 
that the byte is located in. If the sub block is valid then Search Cache returns Yes. 

12. Add To Write Buffer 

Add To Write Buffer adds one record to the write buffer. It also updates the 
Read Buffer if the Update Read Buffer argument is asserted The process of updating the 
Read Buffer is simply changing the requests so that data made available by the write 
request is not requested from memory. Update Read Buffer should not be used unless the 
word and sub block sizes are equal This is because a write request may reduce a read 
request to where the read request will not be large enough to validate a sub block. The 
write request may also be unable to set any valid bits because of sub block alignment. The 
result is that a sub block that was suppose to be read in is not 
D. MEMORY MODEL 

Memory Mode! makes all the necessary calls to simulate main memory. Memory’ 
Model decides which calls to make based on Memory’ Waiting For. This function is called 
every time Time is incremented If there are no read or write requests waiting to be 
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completed, the function does nothing. Memory Model contains a loop that forces the 
procedure to continue modeling until TO A and TOI) are not equal to Time This insures 
that if there are any events that occur in zero clock cycles then the next event is allowed to 
start. 

Memory Model calls Select Memory J Request to choose a request from either the 
read or the write buffers. Memory Model calls Start Reads and Start Writes to simulate 
accessing memory and receiving the first word of a memory request Continue Reads and 
Continue Writes are then called to simulate the memory transfer of the following words of 
data. 

1. Select Memory Request 

Select Memory ; Request is called when memory is waiting for nothing. 

Select Memory > Request chooses a request from either the read or write buffers based on 
priority. The request is not returned however, and the request is left at the top of the buffer 
with its Priority set to zeros and Access In Progress set equal to Yes. If a request is found, 
then Memory / Waiting For is set to Memory > Read Request or Memory > Write Request , 
depending on whether the request was found in the read or write buffer. 

2. Start Reads 

Start Reads begins a read request, simulating the first word read from 
memory. The time to complete this read is called Memory > Access Time. The Block Buffer 
is initialized in preparation to receive the new data words. If Block Waiting For is not 
equal to Nothing then Start Reads will have to wait before allowing the new memory read 



35 



request to start I f Start Reads does have to wait for the cache then Memory Waiting For is 
set equal to Cache Update , otherwise Memory’ Waiting For is set to Memory’ Read Access. 
The new block record is equal to the Read Buffer with its sizes set to zero. This gives the 
Block Memory Request the same block number as the Read Memory Request. The 
Address is aligned to Word Size. The Address must be aligned because the words read in 
will be aligned to Word Size The new Block Memory Request is simply pushed onto the 
Block Buffer. Block Waiting For is set equal to Memory Block Transfer to indicate that 
data is being transferred from memory to the Block Buffer. 

3. Continue Reads 

Continue Memory Reads continues the memory read request started by 
Start Memory Reads. It simulates every read from memory other than the first word, 
which is simulated by Start Memory Reads. The time to complete each word transfer is 
equal to Memory Transfer Time. The block and read buffers are altered every time a word 
is read from memory Once a request is complete, it is removed from the Read Buffer and 
Memory Waiting For is reset to Nothing. Block Waiting For is set to Block ('ache Access 
in preparation to transfer the new data to the cache. If the Completion Tune Estimate for 
the memory read request is not equal to Time then a time prediction error is raised. 

4. Start Memory Writes 

Start Memory Writes begins a memory write request, simulating the first 
word written to memory The time to complete this one word write is called Memory 
Access Time. Memory’ Waiting For is set to Memory Write Access. 
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5 . 



Continue Memory Writes 



Continue Manor y Writes continues the memory write request started by 
Start Memory Writes. Like Continue Memory Reads, it simulates every write to memory 
other than the first word, which is simulated by Start Memory Writes. The time to 
complete each word transfer is equal to Memory Transfer Time. The Write Buffer is 
altered every time a word is written to memory. Once the memory write request is 
complete, it is removed from the Write Buffer , and Memory’ Waiting For is reset to 
Nothing. If the Completion Time Estimate for the memory read request is not equal to 
Time when the request is completed then a time prediction error is raised. 

6. Update Cache 

Update Cache simulates entering data form the Block Buffer into the cache. 
Update Cache first checks whether or not the cache is busy. If it is not, then Cache Busy is 
asserted and Block Wailing For is set equal to Block Cache Transfer. The Block TO A is 
calculated to enable Calculate Time Estimates to predict the completion times for 
additional memory read requests in the buffer. If the cache is busy then the previous 
memory request time completions may be wrong. That is because all of the last estimates 
counted on the old Block TOA. Therefore they all must be recalculated. 

Once the Buffer Cache Access Time has expired then Block Watting For is 
set equal to Nothing and the Cache Busy is deasserted. The read data must then be 
removed from the Block Buffer. The appropriate sub blocks in the cache will then have 
their dirty bits cleared and valid bits set 
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7 . 



Add A Word To Memory Request 



Add A Word To Memory Request adds a word to a Memory Request as if it 
had been read in from memory. The address is first aligned to Word Size. Then, the size is 
incremented by Word Size. This simulates the data being added to the request. 

8. Remove A Word From Memory Request 

Remove A Word Form Memory Request removes a word from a Memory 
Request as if it had been written to memory. A copy of the Address is first stored in Old 
Address. Then, the Address is word aligned and incremented by Word Size. The Required 
Size and Size are then decremented by the difference of the new Address and the Old 
Address. Finally, if the Address is outside the range of the original block, then Address is 
decremented by Block Size to simulate modulo addition This simulates removing a word 
from the memory request, taking into account word and block alignment constraints. 

E. TIME ESTIMATES 

Time estimates are performed to provide a method of testing Cache Model, and 
Memory Model's handling of the read and write buffers. These two procedures are located 
in "TimeEst.c" 

1. Update Time To Execute 

Update Time To Execute calculates the time to complete a memory transfer 
given Memory Request. Memory Request could be a read or write request in a buffer. 
Update Time To Execute changes the Time To Execute field to the new value. Time To 
Execute is calculated by first finding the number of Words To Be Transferred. If the 
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Memory Request is not being accessed then the Time To Execute is simply the Access Time 
plus the Transfer Time multiplied by one less than Words To Be Written. If the Memory 
Request is in progress then the new Time To Execute is dependent on TOA or TOD of the 
next word. Memory Waiting For dictates whether to use the TOA or TOD. If Memory > 
Waiting For is equal to Cache Update then the request has not actually begun transferring 
data. Therefore, the Time To Execute can be calculated as if the read request is not in 
progress. 

2. Calculate Time Estimates 

Calculate Time Estimates updates the Completion Time Estimates for each 
request in both the read and write buffers. This function is called whenever the Cache 
Model adds to the read or write buffers. Calculate Time Estimates must be called every 
time new data is entered into the buffers. This is because all previous estimates did not 
take into account the new data requested. Calculate Time Estimates first orders all entries 
in both the Read Btiffer and the Write Buffer by priority. Then, Calculate Time Estimates 
steps though both buffers simultaneously, each time picking the request that has the highest 
priority and adding the time to execute to the Time Estimate. The Time Estimate becomes 
that requests Completion Time Estimate. This process is repeated until all requests have a 
new Completion Time Estimate. Time To Execute, for cache request, is updated before it 
is used to calculate the Time Estimate. 
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VI. PROGRAM VALIDATION 



A. TESTING SACS 

Program validation was considered to be a paramount issue in designing and 
implementing SACS. The debugging techniques for SACS were engineered during the 
early planning phases, before any code was written. In fact, there was a great deal of 
energy spent trying to make SACS a general event simulator Not only would this have 
made it easier for the user to alter the protocols, but more importantly, it would have been 
easier to test the program. It would have been easier because the number of different kinds 
of event transitions would have been less than the number of different cache argument 
permutations This method was aborted because data that was stored in the cache and the 
buffers was completely different Another problem that plagued this method was that the 
scoreboarding techniques were unique for each buffer Having abandoned the previous 
method, and recognizing that SACS would have dozens of input parameters ( 37 to date), a 
great deal of concern developed over how the program could be tested. It was decided that 
hand testing would prove to be ineffective in eliminating most or all of the programming 
errors. Therefore, an automated testing routine was developed. The testing routine was 
incorporated into the source code of SACS and can be activated using the - test argument 
When the program is in the test mode, it goes into an infinite loop generating 
pseudo-random load and store instructions. Each trace is processed using the same code as 
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if the trace was generated by a designer. Each time a new trace run is executed, the input 
parameters are randomized. This testing method is the backbone of all other validation 
methods for SACS Other error checking is performed during this process. However, the 
random trace and random argument testing is the best method to ensure that all lines of 
code in SACS get executed during the test phase of SACS. This prevents SACS from 
experiencing a catastrophic failure during an actual simulation because almost all 
instructions are executed during the testing phase. SACS tries to predict the number of 
read and write hits for each run. These predictions are compared to the number of cache 
and buffer hits if the input arguments are expected to make the cache and buffer hits reflect 
the predictions. An example of when the input arguments would make it impossible to 
predict a hit or a miss is when the rand block replacement policy is used A block of data 
that has just been read into the cache may be selected as a victim This makes it impossible 
to predict which blocks will be in the cache at the beginning of the next request. Another 
example is when a read forward policy is used and the block buffer is not searched Data 
expected to be in the cache may be in the Block Buffer, or in the Read Buffer, waiting to 
complete the block transfer. This requires that the predicted hits only be compared when 
the block and read buffers are searched It also requires that during the test mode, buffer 
hits will include the read buffer Policies that can not be checked for predicted hits are 
allowed in the test because they can be checked for other things including the simple, yet 
important requirement that the program does not spontaneously abort. 
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The instructions that are randomly generated for a test trace are seeded from 64 test 
vectors These test vectors each have 7 read or write instructions. The number of these 
vectors to be used to generate a trace is randomly chosen. The actual test vectors to be 
used are also randomly chosen. Each test vector is assigned a random set of block 
addresses Each of the block addresses for a particular test vector will map to the same set 
in the cache. The actual data address for each request is formed by taking the block 
address and adding a random number such that the data address is still in the same block. 
The size is also chosen randomly in such a way that the request does not violate block 
alignment. 

Once all the test instructions have been created, they are randomly shuffled in such 
a way that the final number of hits and misses will remain the same as predicted. 

B. CHECKING COMPLETION TIME 

The timing analysis of SACS is so important that it was decided that every timing 
test that could be performed would be performed SACS simulates events based on the 
current time only because some events can be predicted, such as the time that a buffer 
request would be removed from a buffer A good timing test would be to calculate the 
estimated time of completion. Then, check to see if that estimated time is the same as the 
time that the request is removed from the buffer. If they do not match then an error is 
indicated. This kind of error checking goes on during every run whether it's a test run or a 
user's run. 
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C. CHECKING GLOBAL VARIABLES 

SACS uses 82 global variables. Approximately half of the global variables are 
constant during a single run. These variables mostly represent input parameters, and 
although they are changed in between test runs, they remain constant for the rest of the 
trace run. SACS was written in C, a powerful language that permits the programmer to 
create some powerful and elusive bugs. Specifically, C allows assignments to be buried in 
logical expressions. This capability could easily result in altering input parameters instead 
of checking a parameters value. To avoid this kind of error and others like it, copies of all 
constant global variables are made before the beginning of the trace run. At the end of 
every simulated clock cycle these variables are compared to their original copies. If a 
discrepancy is found then an error is indicated. 

Global variables that are not constant are also inspected They are inspected to 
ensure that they are all within acceptable boundaries. These boundaries are not always 
constant. For example, histogram index and total time should always exceed Time. 
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VII. SAMPLE RUNS 



A. EXAMPLE SACS SIMULATION RUN 

In the first simulation run for SACS the default parameters were used. This run 
will demonstrate a write allocation miss and a write through hit This run will also 
demonstrate a read miss that takes advantage of removing duplicates, and how a write 
request can update the read buffer. Table 4 shows the trace data used for the simulation 
run. 



Table 4 TRACE DATA FOR RUN 


Rt-’ijunot 

Type 


Rncjnent 

Addled:" 


uiz- 


Tirvi *- 1 Until 
Next Request 


w 


>: 0 0 0 0 0 10 0 


4 


1 


w 


x0 00 001 OH 


H 


1 


r 


xO 0000104 


- 


1 






The Request Type is either a read or a write request. Read requests are indicated 
with a lower case "r". Write requests are indicated with a lower case "w". The address is 
read as a long hexadecimal integer. The Request Size is a long unsigned decimal integer. 
It represents the size in bytes. Time l inti I Next Request is the time between when the 
CPU's current request is complete and when the CPU makes the next request. The 
simulation run was performed by loading the trace data from Table 4 into an ASCII data 
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file named "SACS.Dat". Then, SACS was started with the trace mode on. The first trace 



display that SACS produced is shown in Figure 6. 
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Figure 6 Trace Display For Time=l 



Figure 6 shows the status of SACS after the first clock cycle. The Cache Waiting 
For field shows that SACS is modeling the cache access. Mentor)’ Waiting For is Nothing 
because the cache does not know if the request is a hit or a miss. Block Waiting For is 
Nothing because no read requests have started. The Next Request Time indicates that the 
CPU will send another request at Time equal to 2. Cache Hit and Buffer Hit are Unknown 
because the cache block still has not been accessed. The request will be mapped to set 
number 16, block 64. 
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The trace display for Time equal to 2 is shown in Figure 7. This display shows that 
the CPU has made the second write request. Again, the Cache Waiting For indicates that 
the cache is accessing block 64. The Memory Waiting For indicates that memory is 
accessing the first word in memory for the last write request. The TOD indicates that the 
first word will be written to memory at Time equal to 5. Cache and buffer hits are again 
( Inknown because block 64 has not been accessed. The set data indicates that the last write 
request at 1 00 validated the first sub block. The Read Buffer has the remaining data 
needed for block 64 The Rcq. field is the number of bytes required to satisfy the CPU 
request None are required in this case because the data was only needed to fulfill a block 
management requirement. The Write Buffer shows the last write request. It also predicts 
that the memory write request will be complete at Time equal to 5. 
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Figure 7 Trace Display For Time=2 
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The next display is for Time equal to 3, and is shown in Figure 8. This display 
shows that cache is still working on the last write request. Cache Waiting For still 
indicates Write Cache Request because the default for a write hit requires one clock cycle 
after the cache has been accessed to update the cache. The memory is still waiting for the 
memory access of the first write memory request. The Next Request Time indicates that 
the CPU is waiting for the cache to finish with the last write request 
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Figure 8 Trace Display For Time= 


3 







Figure 9 shows the display for Time is equal to 4. The last write request has 
completed and the data provided by the write request was placed in block 64. As a result, 
the last two sub blocks are valid. The data was also placed into the Write Buffer. At first, 
it seems as though the two write memory requests should have been combined The 
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resulting request would have had an address of 108 and a size of 12. Because words are 
accessed in memory in modulo form, the data for the first sub block would have been 
accessed last. However, because the last memory write request was in progress, the 
request could not modify its starting address. Therefore, two different requests resulted, 
and the Read Buffer's memory request size has been reduced by 8 bytes. This is an 
example of updating the Read Buffer with write data. This scoreboarding policy is a 
default for SACS, and can be disabled. The result is that the read request does not have to 
access data that was provided by a write request. 
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Figure 9 Trace Display For Time=4 
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Figure 10 shows the trace display for Time equal to 5. The last read request has 
turned out to be a miss. The buffers were also no help. At first glance, it might seem as 
though the read buffer should have provided a buffer hit. This would have been true if 
SACS were in a test mode. However, in a non test mode, the read buffer is not searched 
because the data is not really available. It still has to be read in from memory The first 
write memory request starting at address 100 has completed, as predicted at Time equal to 
5 The next memory request was chosen to be the write request because it had a high 
priority of 1 1, versus the read memory request with a priority of 12. Unfortunately, the 
request began before the cache could raise the priority to 10 Once the write request began, 
the priority went to 0 to prevent interruption 
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Figure 10 Trace Display For Run #1, Time=5 
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From the TOD in Figure 10, it is obvious that little will happen until at least the first 
word is sent to memory. The display trace for Time equal to 8, when the first word is 
written to memory, is shown in Figure 11. It shows how SACS adjusts its buffers to 
represent individual words sent or reo. ed from memory. The Memory Waiting For 
switched to Memory Write Transfer , illustrating the transition from memory access to 
memory transfer. The TOD shows that the write will be complete at Time equal to 9, 
which is a lot better than the 3 clock cycles normally used to access memory. 
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Figure 11 Trace Display ForTime=8 
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Figure 12 shows the completion of the write memory request, and the beginning of 
the read memory request at Time equal to 9. The Block Buffer has also been prepared t 
receive the read memory data. The Block Waiting For indicates that the Block Buffer is 
busy receiving read data from memory. The TOA shows that Time 12 is when the read 
memory request will be complete. 
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Figure 12 Trace Display For Time=9 
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Figure 13 shows the completion of the read memory request at Time equal to 12. 
The Cache Waiting For indicates Nothing because the request was satisfied when the 
required bytes arrived in the block buffer. The memory has nothing to do because both the 
read and the write buffers are empty. The simulation is not finished however, because the 
block buffer still has to update the cache with the new block data. Block Waiting For 
shows that the transfer is in progress. 
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Figure 13 Trace Display ForTime=I2 
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Figure 14 shows the trace display for Time equal to 13. This display shows how 
the block buffer updated block 64. One word of data was provided at address 104, making 
the second sub block valid Once the block transfer was completed, SACS removed the 
memory request from the block buffer 



Last Request: 


Read 


Time : 


13 


Address : 


00000104 


Next Request Time: 


13 


Size : 


02 






Cache Waiting For: 


Nothing 






Memory Waiting For: 


Nothing 


Cache Hit: 


Unknown 


Block Waiting For: 


Nothing 


Buffer Hit: 


Unknown 



Set Block 


Address 


V/D 


V/D 


V/D 


V/D 












00016 00064 


00000100 


1 


0 


1 


0 


1 0 


1 0 












00065 


00000000 


0 


0 


0 


0 


0 0 


0 0 












00066 


00000000 


0 


0 


0 


0 


0 0 


0 0 












00067 


00000000 


0 


0 


0 


0 


0 0 


0 0 












Read Buffer 


Address 




Size 




Req . 


Block 


Priority 


Time 


Req. 


Comp . 


Time 


Write Buffer 


Address 




Size 




Req . 


Block 


Priority 


Time 


Req. 


Comp . 


Time 


Block Buffer 


Address 




Size 




Req. 


Block 


Priority 


Time 


Req. 


Comp . 


Time 


Next Command 


Please [ 


T 


, R 


, s. 


C, G 


#, #, 


Help] »>□ 











Figure 14 Trace Display For Time=13 
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Figure 15 shows the results display. This display is always shown at the end of the 
run. It is interesting to note that even with the SACS default parameters, which lean 
toward providing the fastest response time to all CPU requests, the average access time for 
the one read miss was 8 clock cycles. Had this simulation been done with Dinero HI, the 
user could only have assumed that a 2 byte read would have taken the memory access time 
of 3 clock cycles. 
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VIII. CONCLUSION 



For more than a decade, caches have been designed and built. Despite the time and 
effort spent on cache designs, there seems to be no one design that has emerged as the best 
cache design. Even the most basic choices, such as associativity, block size, and whether 
to use a unified cache or two separate data and instruction caches, has not been a clear 
choice, or at least the correct choice was not agreed upon by all concerned. 

The diversity of cache designs has been caused by budget constraints, changing 
memory technology, and changing CPU bandwidth requirements. Without proper timing 
information, matching the correct cache to the architecture is more of an art than a science 
SACS offers a powerful tool in the early planning phase of a cache design. Its large set of 
scoreboarding, block management, and cache memory arguments allow the designer to 
survey different designs quickly. SACS is well documented and provides the designer with 
a number of debugging tools, including self-testing and global variable bounds checking. 
This makes modifying SACS to simulate a unique design feature extremely easy compared 
to other programs. 

As mentioned throughout this paper, the most critical aspect of SACS is its ability 
to provide the designer with the average access time. Since the ultimate purpose of the 
cache is to minimize the average access time, any simulator that does not provide this 
number can only hope to provide the designer with superficial and misleading data 
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Future developments of SACS will include more elaborate timing information. The 
number of histograms will expand to include what the CPU, memory, and block buffer 
were waiting for during a run. A new stall histogram will be introduced that will allow the 
user to easily modify SACS to analyze any combination of conditions. For example, how 
many times does a read request wait for access to the cache memory while an old write 
miss request updates the allocated block. A new global variable will allow the user to 
change all the histogram displays to probability density tables. 
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APPENDIX 



SOURCE CODE FOR SACS 
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Page 1-0 ** 

SACS . h ** 

★ ★ 

Part Of SACS 1.0 ** 

(StillAnother Cache Simulator) r ** 

★ ★ 

Program Modified: 3/17/94 ** 

File Modified: 3/17/94 ** 

★ ★ 

Author: William G. Smith ** 

Address: Electrical Engineering Department ** 

Naval Postgraduate School ** 

Monterey, CA 93940 ** 

★ ★ 

Copyright 1994, William G. Smith ** 

★ ★ 

Permission to use, copy, modify, and distribute this software and ** 

its documentation for any purpose and without fee is hereby granted ** 

provided that the above copyright notice appears in all copies. No ** 

modified version of this program should be redistributed without the ** 

authors consent. William G. Smith makes no warranty or ** 

representation, promise of guarantee, either expressed or implied, ** 

with respect to this software's ability to produce valid results. ** 

This program is provided "as is" any financial, personal or property ** 

damage caused by the use of this program is the responsibility of the ** 

user. ** 

* 



/*" 
★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
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► ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-*** 

Page 1- 1 

SACS .h 

Still Another Cache Simulator 
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WordAddress (Address) 
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Get.c 
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Display. c 
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Array . c 
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Checking. c 
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★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■a-* 




r-k-k-tc-k-k-k + Hr 


*★★★★*★ / 



#ifndef CACHE. H 

# define CACHE. H 



#define ClearScreen 



ClearScr 
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Page 1- 2 ** 

★ ★ 



escript ion : 



Enumeration Definitions 



★ ★ 



★ ★ 



Listed below are the enumerations used in the SACS environment. 
aitingForTypes, and MemoryWait ingForTypes are on listed on the 
ollowing page. 






YesNoTypes { 

No, 

Yes, 

Unknown 

} ; 

RequestTypes { 

None, 

Read, 

Write, 

NumberOfRequestsAvailable 

} ; 

31ockReplacementPolicyTypes { 

LRU, 

FIFO, 

RAND, 

NumberOf Replacement PoliciesAvailable 

}; 



L^ritePolicyTypes 



{ 

WriteThrough, 

WriteBack, 

NumberOfWntePoliciesAvailable 

} ; 



i tfriteMissPolicyTypes { 

WriteAround, 

WriteAllocate, 

NumberOf Wr it eMissPolicies Available 

}; 



** Page 1-3 ** 
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★ ★ 


★ ★ 


★ ★ 


Enumeration Definitions ** 


★ ★ 


continued ** 



★ ★ ★ ★ 



enum CacheWaitingForTypes 


< 

Nothing, 

CacheWaitingForReadCacheRequest, 
CacheWaitingForWriteCacheRequest, 
CacheWaitingForReadMemoryRequest, 
CacheWaitingForWriteMemoryRequest, 
CacheWaitingForFullReadBuf fer, 
CacheWaitingForFullWnteBuf fer, 
CacheWaitingForCPUCacheAccess, 
NumberOfCacheWait ingForsAvailable 
}; 


enum MemoryWaitingForTypes 


{ 

NothingTwo, 

MemoryWaitingForMemoryReadRequest, 
MemoryWaitingForMemoryReadAccess, 
MemoryWaitingForMemoryReadTransfer, 
MemoryWaitingForMemoryWriteRequest , 
Memory Wait ingForMemoryWr it eAccess, 
MemoryWait ingForMemory Writ eTrans fer, 
MemoryWaitingForCacheUpdate, 
NumberOf Memory Wait ingForsAvailable 
} ; 


enum BlockWaitingForTypes 


{ 

NothingThree, 

MemoryBlockTransfer, 
BlockCacheAccess, 
BlockCacheTransfer, 
NumberOfBlockWait ingForsAvailable 
}; 



***★★★****★★★★★★★★★★★**★★★★★*★★★★★★★*★★*★★★★★*★★★★★★★★**★★*★★★*•*■★*★■*•*•****•*** 
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Type Definitions ** 

Description: ** 

* ★ 

These are all of the type definitions used in the SACS ** 

environment, excluding enumeration types which are listed on the last ** 

two pages, ** 

★ ★ 



pedef 

pedef 

sedef 

Dedef 

oedef 

Dedef 

Dedef 

Dedef 

Dedef 



unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 



int TimeType; 

int ScoreType; 

int AddressType; 

int CacheSizeType; 

int SizeType; 

int Buffer SizeType; 

int PriontyType; 

int AssociativityType; 

int HistogramlndexType ; 



?edef 

Dedef 

)edef 

^edef 

)edef 

)edef 

)edef 

)edef 



enum YesNoTypes 
enum RequestTypes 
enum BlockReplacementPolicyTypes 
enum WriteMissPolicyTypes 
enum WritePolicyTypes 
enum CacheWaitingForTypes 
enum MemoryWaitingForTypes 
enum BlockWaitingForTypes 



YesNoType; 

RequestType; 

BlockReplacementPolicyType ; 
Writ eMissPolicy Type; 
WritePolicyType; 
CacheWaitingForType; 

Memory Wait ingForType ; 
BlockWait ingForType; 



Iruct MemoryRequestStructType 

{ 



AddressType 

SizeType 

SizeType 

SizeType 

PriorityType 

YesNoType 

TimeType 

TimeType 

}; 



Address; 

Size; 

RequiredSize; 

Block; 

Priority; 

Access InProgress; 
TimeToExecute; 

Complet lonTimeEs t imate ; 



i*edef struct MemoryRequestStructType Memo ryRequest Type; 



tuct Buffer Struct Type 

{ 

MemoryRequestType MemoryRequest [10] ; 
YesNoType Full; 

YesNoType Empty; 

Buf f erSizeType Next ; 

Buf ferSizeType Max; 

CacheWaitingForType WaitingForFlag; 

} ; 

^edef struct Buf ferStructType BufferType; 
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Inline Function Definitions 



★ ★ 
★ ★ 



★ 

★ ★ 

★ ★ 

★ ★ 

* ★ ★ ★ 

** Description: ** 

★ ★ ★ ★ 

** These macros act as inline functions. They are the only ** 

** macros which act as inline functions within the SACS environment, ** 

** except those located in "Test SACS . c" . ** 

★ ★ * ★ 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-A-* j 



#define SubBlock (Address) 
♦define Set (Address) 



( ( (Address) %BlockSize) /SubBlockSize) 
( ( (Address) /BlockSize) %NumberOf Sets) 



♦define BlockAddress (Address) ( ( (Address) /BlockSize) *BlockSize) 

♦define WordAddress (Address) ( ( (Address) /WordSize) *WordSize) 

♦define SubBlockAddr ess (Address) ( ( (Address) /SubBlockSize) ^SubBlockSize) 
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List of SACS . c Function Declarations 
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★ ★ 




escription: ** 

★ ★ 

This is a list of function declarations within the file scope ** 

f " SACS . c" . 

★ ★ 



n 


int 


main () ; 


/* Page 


2- 8 


*/ 


n 


void 


LoadArgument s ( ) ; 


/* Page 


2-11 


V 


n 


unsigned long 


int ScanArgument () ; 


/* Page 


2-14 


*/ 


n 


void 


InitializeProgrammersGlobalVariables () ; 












/* Page 


2-15 


*/ 


n 


void 


InitializeBuf fers () ; 


/* Page 


2-16 


*/ 


n 


void 


Def ineArrays ( ) ; 


/* Page 


2-17 


*/ 


n 


void 


FreeArrays () ; 


/* Page 


2-18 


* f 


n 


void 


OpenDataFile () ; 


/* Page 


2-19 


*/ 


n 


void 


CloseDataFile ( ) ; 


/* Page 


2-20 


*/ 


n 


void 


PauseForCommand ( ) ; 


/* Page 


2-21 


*/ 


n 


void 


Pause () ; 


/* Page 


2-23 


*/ 



** Page 1- 7 ** 
** SACS .h • ** 
★ ★ ★ ★ 

** List of Cache. c Function Declarations ** 



★ ★ 
★ ★ 
★ ★ 



Description : 

This is a list of function declarations within the file scope 
of "Cache. c". 



★ ★ 
★ ★ 



★ ★ 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A--****** 



extern 


void 


CacheModel () ; 


/* 


Page 


4- 3 


*/ 


extern 


void 


IsRequestAHit () ; 


/* 


Page 


4- 4 


*/ 


extern 


void 


ReadHit () ; 


/* 


Page 


4- 5 


*/ 


extern 


void 


ReadMiss ( ) ; 


/* 


Page 


4- 6 


*/ 


extern 


void 


WriteHit ( ) ; 


/* 


Page 


4- 7 


*/ 


extern 


void 


WriteMiss ( ) ; 


/* 


Page 


4- 8 


* / 


extern 


void 


AccessCache () ; 


/* 


Page 


4-10 


* / 


extern 


void 


SelectBlockVictimO / 


/* 


Page 


4-11 


V 


extern 


void 


SetDirtyBits () ; 


/* 


Page 


4-13 


*/ 


extern 


void 


WriteDirtySubBlocks ( ) ; 


/* 


Page 


4-14 


*/ 


extern 


void 


AddToReadBuf fer ( ) / 


/* 


Page 


4-16 


*/ 


extern 


YesNoType 


SearchCache () ; 


/* 


Page 


4-20 


*/ 


extern 


void 


AddToWriteBuf fer () ; 


/* 


Page 


4-21 


*/ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-A-** 
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★ ★ 



List of Memory. c Function Declarations ** 

★ ★ 

escription: ** 

★ * 

This is a list of function declarations within the file scope ** 

f Memory.c ** 

★ ★ 



n 


void 


Memory Mo del () ; 


/* 


Page 


5- 3 


*/ 


n 


void 


SelectMemoryRequest () ; 


/* 


Page 


5- 4 


*/ 


n 


void 


StartMemoryReads () ; 


/* 


Page 


5- 5 


*/ 


n 


void 


ContinueMemoryReads () ; 


/* 


Page 


5- 6 


*/ 


n 


void 


StartMemoryWrites () ; 


/* 


Page 


5- 8 


*/ 


n 


void 


ContmueMemoryWrites () ; 


/* 


Page 


5- 9 


*/ 


n 


void 


UpdateCache () ; 


/* 


Page 


5-11 


*/ 


n 


void 


AddAWordToMemoryRequest () ; 


/* 


Page 


5-13 


*/ 


n 


void 


RemoveAWordFromMemoryRequest () ; 


/* 


Page 


5-14 


*/ 






I ★ ★ ★ 
★ ★ 
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List of TimeEst.c Function Declarations 
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Description : 



★ ★ 
★ ★ 
★ ★ 
★ ★ 



** This is a list of function declarations within the file scope 

** of TimeEst.c ** 

★ ★ ★ •i 



extern void UpdateTimeToExecute ( ) ; 
extern void CalculateTimeEstimates ( ) ; 



/* Page 6- 3 */ 
/* Page 6- 5 */ 



List of Get . c Function Declarations 



Description : 

This is a list of function declarations within the file scope 
of "Get.c". 



/* Page 
/* Page 
/* Page 



ern void GetNextRequest ( ) ; 

ern void GetNextFileRequest ( ) ; 

ern void GetNextKeyBoardRequest ( ) ; 



^★★★★★★★★★★★★★★★★★★★★★*********************************'*''****'*'**'*'**'*'**''*’'*’’* - **''**'A'* 

** Page 1-11 ** 

** SACS .h ** 

★ ★ ★ * 

** List of Display. c Function Declarations 



** Description: 



★ ★ 
★ ★ 



This is a list of function declarations within the file scope 
** of "Display . c" . 



extern void 
extern void 
extern void 
extern void 
extern void 
extern void 

extern void 
extern void 



DisplayTrace () ; 

DisplayCurrentRequest () ; 
DisplayWaitingFors () ; 
DisplayBlock () ; 

DisplayBuf fers () ; 
DisplayBuf fer () ; 

DisplayRequestsBreakDown () ; 
DisplayRequestHistogramO ; 



extern void DisplayStallHistogram ( ) ; 

extern ScoreType LastScreenHistogramScore () ; 
extern void DisplayCacheArguments ( ) / 

extern void DisplayHelp ( ) ; 



extern void 



extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 

extern 



void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 



extern void 
extern void 
extern void 



DisplayTestingHeader () ; 

PrintYesNo ( ) ; 

PrintRequest () ; 
PrintReplacementPolicy ( ) ; 
PrintWritePolicy ( ) ; 
PnntWriteMissPolicy () ; 
PnntWaitingFor ( ) ; 
PnntMemoryWait ingFor ( ) ; 
PrintBlockWait mgFor ( ) ; 

PrintTime () ; 
PrintTimeCentered () ; 
PrintScoreCentered ( ) ; 
PrintAddress () ; 
PrintCacheSize () ; 
PrintSize ( ) ; 

PrintSize2 () ; 

PrintBuf fer Size () ; 
PrintPriority () ; 
PrintAssociativity () ; 
PrintHistogramlndex ( ) ; 

PrintBit () ; 

PrintPercent () ; 
PrintAveAccess () ; 



/* 

/* 

/* 

/* 

/* 

/* 
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V 


Page 


8- 4 


*/ 


Page 


8- 5 


*/ 


Page 


8- 6 


*/ 


Page 


8- 7 


*/ 


Page 


8- 8 


*/ 


Page 


8- 9 


* / 
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8-11 


*/ 


Page 


8-13 


*/ 


Page 


8-14 


*/ 


Page 


8-15 


*/ 


Page 


8-17 


*/ 


Page 


8-18 


*/ 


Page 


8-19 


*/ 


Page 


8-19 


*/ 


Page 


8-19 


*/ 


Page 


8-19 


* / 


Page 


8-19 


*/ 


Page 


8-19 


*/ 


Page 


8-19 


*/ 


Page 


8-19 


*/ 


Page 


8-20 


*/ 


Page 


8-20 


*/ 


Page 


8-20 


*/ 


Page 


8-20 


*/ 


Page 


8-20 




Page 


8-20 


*/ 


Page 


8-20 


*/ 


Page 


8-21 


*/ 


Page 


8-21 


*/ 


Page 


8-21 


* / 


Page 


8-21 


*/ 


Page 


8-22 


*/ 


Page 


8-22 


*/ 


Page 


8-22 


*/ 



★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★Hr* 



SACS .h 



Page 1-12 ** 
★ ★ 



List of Record. c Function Declarations 



Description: ** 

★ ★ 

This is a list of function declarations within the file scope ** 

of "Record. c". ** 

★ ★ 

IT*************************************************************************/ 



ern 


void 


RecordRequest () ; 


/* 


Page 


9- 3 


*/ 


ern 


void 


RecordStall () ; 


/* 


Page 


9- 5 


*/ 


ern 


void 


RecordForMatlab ( ) ; 


/* 


Page 


9- 7 


* / 



!'★★★★★★★★★★★*★ 1 






★ ★ 
★ ★ 
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List of Buffer. c Function Declarations 
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★ ★ 



★ ★ 



Description : 



★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 

★ ★ ★ ★ 
★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A" i 



** This is a list of functions declarations within the file scope 

** of "Buffer.c". 



extern 


void 


Push () ; 


/* 


Page 


10- 3 


*/ 


extern 


MemoryRequestType 


Pop () ; 


/* 


Page 


10- 4 


*/ 


extern 


void 


ChangeTopMemoryRequest () ; 


/* 


Page 


10- 5 


*/ 


extern 


void 


Append ( ) ; 


/* 


Page 


10- 6 


*/ 


extern 


MemoryRequestType 


View ( ) ; 


/* 


Page 


10- 7 


*/ 


extern 


void 


Clear () ; 


/* 


Page 


10- 8 


*/ 


extern 


void 


Order () ; 


/* 


Page 


10- 9 


*/ 


extern 


void 


Splice 0 ; 


/* 


Page 


10-10 


*/ 


extern 


YesNoType 


Search ( ) ; 


/* 


Page 


10-12 


*/ 


extern 


YesNoType 


UpdatingReadBuf fer () ; 


/* 


Page 


10-13 


*/ 


extern 


void 


RemoveZeroSizes () ; 


/* 


Page 


10-15 


*/ 


extern 


YesNoType 


NoRequestsLeft () ; 


/* 


Page 


10-16 


*/ 






★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★♦★★★★★★★★★★★★★Ik- 



★ ★ ★ ★ ★ 
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List of Array. c Function Declarations ** 

★ ★ 

Description: ** 

★ ★ 

This is a list of function declarations within the file scope ** 

of "Array. c". ** 

★ ★ 



rn 


int *DefineArraylD () ; 


/* 


Page 


11- 3 


*/ 


rn 


int **Def ineArray2D () ; 


/* 


Page 


1 

i — i 
i — i 


*/ 


rn 


void FreeArraylD ( ) ; 


/* 


Page 


11- 5 


*/ 


rn 


void FreeArray2D ( ) ; 


/* 


Page 


11- 6 


*/ 



j ★ ★ ★ 
★ ★ 

★ ★ 

★ ★ 

+ *■ 

★ ★ 
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SACS .h ** 

★ ★ 

List of TestSACS.c Function Declarations ** 



** Description: ** 
★ ★ ★ ★ 

** This is a list of functions declarations within the file scope ** 
** of "TestSACS.c”. ** 
★ ★ ★ ★ 






extern 


void 


ChangeArguments 0 ; 


/* 


Page 


12- 6 


V 


extern 


void 


TestSACS () ; 


/* 


Page 


12- 8 


V 


extern 


void 


CreatelnstructionSets () ; 


/* 


Page 


12- 9 


*/ 


extern 


void 


Shuf f linglnstructionSets () ; 


/* 


Page 


12-12 


*/ 


extern 


YesNoType 


CanBeSwitched () ; 


/* 


Page 


12-14 


V 


extern 


void 


WritelnstructionSet () ; 


/* 


Page 


12-15 


*/ 
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List of Checking. c Function Declarations 
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Description : 



This is a list of function declarations within the file scope 
of "Checking . c M . 



+ ★ 
★ ★ 
★ * 
★ * 

★ 

★ ★ 
★ ★ 
★ ★ 
★ 



• ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-A-*** 



ern 

.ern 

.ern 

.ern 

.ern 

.ern 

.ern 

.ern 

.ern 

.ern 

.ern 

.ern 

.ern 

.ern 



void Checking (); 
void CheckingConstants () ; 

void PrintConstError () ; 

void CheckingForValuesOutOfBounds ( ) ; 

void PrintTimeBoundaryError ( ) ; 

void PrintScoreBoundaryError ( ) ; 

void PrintSizeBoundaryError ( ) ; 

void PrintEnumBoundaryError ( ) ; 

void CheckingForlnconsistencies () ; 

void PrintTotalTimeError () ; 

void Print TotalScoreError ( ) ; 

void CheckingPredictions () ; 
void Print ScorePredict ionError ( ) ; 

void PrintTimePredict ionError () ; 



-★★★★★★★★★■A-* 
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*/ 
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*/ 
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*/ 
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*/ 
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*/ 
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13-17 


*/ 
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13-18 


*/ 


Page 


13-19 


*/ 
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*/ 


Page 
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*/ 


Page 


13-23 


*/ 


Page 


13-24 


*/ 


Page 


13-25 


*/ 



idif 






/* 
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★ ★ 
* * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
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★ * 

★ ★ 
★ ★ 
* 

★ ★ 
★ ★ 
★ ★ 



Author: William G. Smith 

Address: Electrical Engineering Department 

Naval Postgraduate School 
Monterey, CA 93940 

Copyright 1994, William G. Smith 

Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 

This program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
user . 



★ ★ 



★ ★ 



★ ★ 
★ ★ 
•k ★ 
★ ★ 



★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



***************************************************************************** ^ 



Still Another Cache Simulator 



Description : 

SACS simulates all functions one clock cycle at a time using a 
global variable named Time. Normally it is preferred to preform timing 
simulations using event queues so that time can advance to the next 
event. However, in most cache simulations so many things happen in one 
clock cycle that en event queue would probably not improve the 
preformance of the simulator 

In the main event loop of SACS, Time is incremented one clock 
cycle at a time. Time is never changed by any other procedure. 

The requests are entered into the simulation from GetNextRequest . 
Simulation of all events is performed by the Main Event Loop calling 
CacheModel, MemoryModel, and UpdateCache. 

The main procedure of SACS seems to call simulations in a fairly 
strange order. This is because SACS is insuring that all events that 
can be started, during a particular clock cycle are started, and that 
all events that can bomplete during a particular clock cycle do. It 
also gives an inherent priority to the cache access events. 

Specifically accesses from the CPU to the cache are given higher 
priority that accesses from the BlockBuffer. This is why the Update 
Cache procedure is found in three different places in the main loop. 
Memory Model calls are found before and after the CacheModel. This 
allows memory events that are to complete during a clock cycle to do 
so. The Cache Model will then have the benefit of the newly arrived 
data. The MemoryModel call after the CacheModel call insures that any 
new memory request made by the cache are started that clock cycle. 

SACS' s main loop includes the source code to control testing, 
checking, and tracing. The DesiredTime variable is controlled entirely 
by the MainEventLoop . DesiredTime represents a user request to advance 
the simulation to a particular time without the trace on. SACS can not 
run Time backwards. However if the Desired Time. The user can make 
time requests using arguments "G #", ” #" , . 

Throughout MainEventLoop, CacheWaitingFor is checked to see if 
it's equal to Nothing. This indicates that the last request has been 
serviced and that the cache is ready for the next request . The 
procedures that model specific events as ReadHit, ReadMiss, and 
AccessCache are called repeatedly during their simulations they use 
Cache Waiting For and Time to determine what to do next. If any of 
these procedures needs to wait for a period either to simulate an 
access or because a resource is not available, then they will set Cache 
Waiting For to the appropriate value. The modeling procedures in 
Memory Model work the same way using Memory Waiting For. 

Whenever SACS finds an error or a discrepancy then the boolean 
variable Discrepancy Found is set to Yes. This forces SACS into a 
trace mode so that the user may try to identify the cause of the error. 
In test mode a discrepancy forces SACS out of test mode so that the 
trace file that caused the error is not erased by a new file. 



★ ★ 
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* ★ 



★ ★ 
★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
* ★ 



SACS . c 

Still Another Cache Simulator 
continued 



SACS.c contains the source code for main(), which contains the 
main loop. All initialization of global variables, array definitions, 
and file management are done inside "SACS.c". 

For information on what SACS does see the User's Guide. 

For information on how to run SACS see the User's Guide. 

For information on how to modify SACS see the Programmer's Guide. 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 


For information on how SACS works see the Programmer' 

Table of Contents 


s Guide. 
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★ ★ 


★ ★ 


main() 




2- 8 


* ★ 


* ★ 


LoadArguments ( ) 




2-11 


★ ★ 


* ★ 


ScanArgument ( ) 




2-14 


★ ★ 


★ ★ 


InitializeProgrammersGlobalVariables () 


. Page 


2-15 


★ ★ 


★ * 


InitializeBuffers () 




2-16 


★ ★ 


★ ★ 


DefineArrays () 




2-17 


★ ★ 


★ ★ 


FreeArraysO 




2-18 


★ ★ 


★ ★ 


OpenDataFile () 




2-19 


★ ★ 


★ ★ 


CloseDataFile () 




2-20 


★ ★ 


★ ★ 


PauseForCommandO 


, . Page 


2-21 


★ ★ 


★ ★ 
★ ★ 


Pause () 




2-23 


★ ★ 
★ ★ 


★ ★ ★ 




★ ★ ★ j 



#include <stdlib.h> 
♦include <stdio.h> 



♦include "SACS .h" 
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User Defined Global Variables 
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★ ★ 

★ ★ 
★ ★ 



Description: ** 

★ ★ 

These variables represent the programs input parameters. ** 

★ ★ 



heSizeType 

eType 

eType 

ociat ivityType 
eType 

eType 

eType 

eType 

eType 

eType 

eType 

eType 

eType 

eType 

ferSizeType 

ferSizeType 

ckReplacementPolicyType 

tePolicyType 

teMissPolicyType 



CacheSize 


= 


8192; 


/* 


-cs 


*/ 


BlockSize 


= 


16; 


/* 


-bs 


*/ 


SubBlockSize 


= 


4; 


/* 


-sbs 


*/ 


Associativity 


= 


4; 


/* 


-a 


* / 


WordSize 


= 


4; 


/* 


-ws 


*/ 


ReadCacheAccessTime 


= 


1; 


/* 


-rcat 


* / 


ReadCacheHitTime 


= 


0; 


/* 


-rcht 


*/ 


ReadCacheMissTime 


= 


0; 


/* 


-rcmt 


V 


WriteCacheAccessTime 


= 


1; 


/* 


-wcat 


*/ 


Writ eCacheHit Time 


= 


1; 


/* 


-wcht 


*/ 


WnteCacheMissTime 


= 


0; 


/* 


-wcmt 


*/ 


MemoryAccessTime 


= 


3; 


/* 


-mat 


*/ 


MemoryTrans f erTime 


= 


l; 


/* 


-mtt 


*/ 


Buf f erCacheAccessTime 


= 


l; 


/* 


-beat 


*/ 


ReadBuf f erSize 


= 


4; 


/* 


-rbs 


* / 


WriteBuf f erSize 


= 


4; 


/* 


-wbs 


*/ 


BlockReplacementPolicy 


= 


LRU; 


/* 


-brp 


*/ 


WritePolicy 


= 


Writ eThrough ; 


/* 


-wp 


*/ 


WriteMissPolicy 


= 


WriteAllocate 


; /* 


-wmp 


*/ 



NoType 


ReadForward 


= 


Yes; 


/* 


-rf 


-drf 


* / 


NoType 


CPUWaitsForCacheWrites 


= 


No; 


/* 


-ewfew -dewfew 


* / 


NoType 


SearchBlockBuf f er 


= 


Yes; 


/* 


-sbb 


-dsbb 


* / 


NoType 


UpdateReadBuf f er 


= 


Yes; 


/* 


-urb 


-durb 


*/ 


NoType 


RemoveReadDuplicates 


= 


Yes; 


/* 


-rrd 


-drrd 


*/ 


NoType 


RemoveWriteDuplicates 


= 


Yes; 


/* 


-rwd 


-drwd 


*/ 


orityType 


ReadPriority 


= 


1; 




/* - 


-rpr 


*/ 


orityType 


WritePriority 


= 


2; 




/* ~ 


-wpr 


*/ 


orityType 


ReadForWnteAllocatePriority 


= 


3; 




/* ~ 


-rfwapr 


*/ 


orityType 


WriteDirtyBlockPriority 


= 


4; 




/* - 


-wdbpr 


*/ 


orityType 


NoPriority 


= 


100; 




/* - 


-npr 


*/ 



iMoType Trace 
iMoType Check 
iloType Test 



No; /* 

Yes; /* 

No; /* 



-t -dt */ 

-c -dc */ 

-test */ 



i NoType 


KeyBoardIO 


= No; 


/* 


-kbio 


-fio */ 


1C 


*DataFileName 


= " SACS . Dat " ; 


/* 


-f 


*/ 



. :ogramIndexType ScreenHistogramMaxIndex 
:ogram!ndexType FileHistogramMaxIndex 



5; /* 

10 ; /* 



-shmi 

-fhmi 



/ 

/ 



** Page 2-4 ** 
** SACS . c ** 
★ ★ ★ ★ 

** Programmer Defined Global Variables. ** 
★ ★ ★ ★ 



Time Type Time; 

Time Type DesiredTime; 

CacheWaitingForType CacheWaitingFor ; 
MemoryWaitingForType MemoryWaitingFor ; 
BlockWaitingForType BlockWaitingFor; 
YesNoType DiscrepancyFound; 



YesNoType 

YesNoType 

YesNoType 



CacheHit; 

BufferHit; 

CacheBusy; 



RequestType 

RequestType 

AddressType 

SizeType 

SizeType 

TimeType 



Request; 

LastRequest ; 
RequestAddress; 
RequestSize; 
RequestBlockNumber; 
TimeOfNextRequest ; 



SizeType 

SizeType 

SizeType 



NumberOf Blocks ; 
NumberOf SubBlocks ; 
NumberOfSets; 



AddressType 

TimeType 

SizeType 

YesNoType 

YesNoType 



*CacheBlockAddress; /* 
*LastCacheBlockAccessTime; 
*CacheNextBlock; /* 
**CacheValidBit ; /* 
**CacheDirtyBit ; /* 



[NumberOf Blocks] */ 

[NumberOfSets] */ 
[NumberOf Blocks] */ 
[NumberOf SubBlocks ] */ 



TimeType 

TimeType 

TimeType 

TimeType 

ScoreType 

ScoreType 

ScoreType 

ScoreType 

ScoreType 

ScoreType 



**RequestTimeHistogram; /* [NumberOf RequestsAvailable] */ 

/* [FileHistogramMaxIndex] */ 

**StallTimeHistogram; /* [NumberOfWaitingForsAvailable] */ 

/* [FileHistogramMaxIndex] */ 

*TotalRequestTime; /* [NumberOfRequestsAvailable] */ 

*TotalStallTime; /* [NumberOfWaitingForsAvailable] */ 

♦NumberOf Accesses; /* [NumberOfRequestsAvailable] */ 

*NumberOf CacheHit s ; 

*NumberOfBuf f erHits ; 

*PredictedNumberOf Accesses ; 

^Predict edNumberOf Hits ; 

TotalNumberOfAccesses = 0; /* Not reset during test */ 



ScoreType 

ScoreType 

ScoreType 



TotalNumberOfWordsReadFromMemory; 
TotalNumberOfWordsWnttenToMemory; 
TotalNumberO f Words Writ tenToCache; 



Buf ferType 
Buf ferType 
Buf ferType 



ReadBuf fer ; 
WriteBuf fer; 
BlockBuf f er ; 



AddressType 

TimeType 

TimeType 

TimeType 



MAR; 

TOA; 

TOD; 

BlockTOA; 



FILE *DataFile; 

YesNoType EndOfDataFile; 






SACS . c 
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★ ★ 



Programmer Defined Global Variables 
continued 



Enumerator Strings 



★ ★ 
★ ★ 



Description: ** 

★ ★ 

Enumerator strings are string copies of enumeration types. These ** 
are used for display purposes. ** 

★ ★ 



: *YesNoString [3] = 

{ 

"No 

"Yes 

"Unknown" 

} ; 

: ♦Requeststring [NumberOfRequestsAvailable] = 

{ 

"None ", 

"Read ", 

"Write" 

}; 



: ♦ReplacementPolicyStnng [NumberOfReplacementPoliciesAvailable ] = 

{ 

"LRU ", 

"FIFO", 

"RAND" 

} ; 



: *WritePolicyString [NumberOfWritePoliciesAvailable] = 

{ 

"Write Though", 

"Write Back " 

}; 



: ♦WriteMissPolicyString [NumberOfWriteMissPoliciesAvailable] = 

{ 

"Write Around ”, 

"Write Allocate" 

>; 



'★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■a* 
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SACS . c 

Programmer Defined Global Variables 
continued 

Enumerator Strings 
continued 



★ ★ 
★ ★ 
* ★ 
★ ★ 
★ ★ 
★ ★ 



** Description: 



** numerator strings are string copies of enumeration types. These ** 
** are used for display purposes. ** 
★ * * * 
★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A-* j 



char *CacheWait ingForSt ring [NumberOf CacheWaitingForsAvailable ] = 

{ 

"Nothing ", 

"Read Cache Request ", 

"Write Cache Request ", 

"Read Memory Request ", 

"Write Memory Request", 

"Full Read Buffer 
"Full Write Buffer ", 

"CPU Cache Access 

}; 

char *MemoryWait ingForString [NumberOfMemoryWaitingForsAvailable ] = 

{ 

"Nothing ", 

"Memory Read Request ", 

"Memory Read Access ", 

"Memory Read Transfer ", 

"Memory Write Request ", 

"Memory Write Access ", 

"Memory Write Transfer", 

"Cache Update " 

} ; 

char *BlockWaitingForString [NumberOfBlockWaitingForsAvailable ] = 

{ 

"Nothing ", 

"Memory Block Transfer", 

"Block Cache Access ", 

"Block Cache Transfer " 

}; 



List of SACS.c Function Declarations 



★ ★ 



Description: ** 

★ ★ 

This is a list of function declarations within the file scope ** 

of "SACS.c" . 

★ ★ 

tirieir1r++icieieirieirieicic + ir* + ieir+ieirie*+ieir+ + iriciric+ + ieirieic + + + iritie + ieir + ir + ir + + icieie-k-kicir-k4cic1r + ieieir-kie j 





main ( ) ; 


/* 


Page 


2- 8 


*/ 


i 


LoadArguments () ; 


/* 


Page 


2-11 


*/ 


igned long 


int ScanArgument ( ) ; 


/* 


Page 


2-14 


*/ 


i 


InitializeProgrammersGlobalVariables () / 


/* 


Page 


2-15 


*/ 


i 


InitializeBuf f ers () / 


/* 


Page 


2-16 


*/ 


i 


DefineArrays () ; 


/* 


Page 


2-17 


*/ 


i 


FreeArrays () ; 


/* 


Page 


2-18 


*/ 


i 


OpenDataFile () ; 


/* 


Page 


2-19 


*/ 


i 


CloseDataFile ( ) ; 


/* 


Page 


2-20 


*/ 


ii 


PauseForCommand ( ) ; 


/* 


Page 


2-21 


*/ 


i 


Pause () ; 


/* 


Page 


2-23 


*/ 
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★ ★ 



★ ★ 

** SACS . C 

★ * ★★ 

** main ** 

★ ★ ★ ★ 



mam(argc, argv) 
int argc; 
char *argv [ ] ; 

{ 

LoadArguments (argc, argv) ; 

if (KeyBoardIO==No || Test==Yes) OpenDataFile ( ) ; 
Time=0; 



while (Time==0 I I Test==Yes) 



if (Test==Yes) ChangeArguments () ; 

InitializeProgrammersGlobalVariables () ; 

InitializeBuf fers () ; 

DefineArrays () ; 

if (Test==Yes) TestSACS (PredictedNumberOfAccesses, PredictedNumberOfHits) 

RecordRequest (NumberOfRequestsAvailable) ; /* Reseting LastTimes */ 
RecordStall (NumberOfCacheWaitingForsAvailable) ; 

CheckingConstants (Yes) ; 

GetNextRequest () ; 

CacheHit=Unknown; 

Buf ferHit=Unknown; 



★ *■*★★*★★★★★★***★★★★★*★******★★★★*★★★*****★★★****■*•*★★★*★★★★*★★★★★★★*★★★★★★★★ 



SACS . C 



Main Event Loop. 



Page 2- 9 



★ ★ 
★ ★ 



★★★★★★**★★★★*++******************★*★********★********★★★★★★*★★★★★★**★★★★★★, 



while ( (Request+CacheWaitingFor+MemoryWaitingFor>Nothing | | 
Time<=TimeOfNextRequest ) & & 

DiscrepancyFound==No & & 

Time>0 ) 



if (BlockWaitingFor==BlockCacheTransfer) UpdateCache () ; 

MemoryModel ( ) ; 

CacheModel () ; 

if (BlockWaitingFor==BlockCacheAccess && Buf f erCacheAccessTime==0) 
UpdateCache () ; 

MemoryModel ( ) ; 

RecordRequest (Request) ; 

if (CacheWaitingFor==Nothing) Request =None; 

RecordRequest (Request) ; 

RecordStall (CacheWaitingFor) ; 

if (Time==DesiredTime) { Trace=Yes; DesiredTime=0; } 

if (CacheWaitingFor l=Nothing && 

( (CPUWaitsForCacheWrites && Request==Write) || Request==Read) ) 
TimeOfNextRequest++; 

if (Time>=TimeOfNextRequest && CacheWaitingFor==Nothing) 
GetNextRequest () ; 

CacheHit=Unknown; Buf f erHit=Unknown; 
if (Request==None) 

{ 

if (BlockWaitingFor==BlockCacheAccess) UpdateCache () ; 

Time++; 

RecordStall (CacheWaitingFor) ; 

RecordRequest (Request) ; 

Time — ; 

if (Check) Checking (); 
if (Trace) PauseForCommand () ; 

Time++; 

) 

) 

else 

{ 

if (BlockWaitingFor==BlockCacheAccess) UpdateCache ( ) ; 

Time++; 

RecordStall (CacheWaitingFor) ; 

RecordRequest (Request) ; 

Time — ; 

if (Check) Checking (); 
if (Trace) PauseForCommand () ; 

Time++; 

} 

if (Time>DesiredTime && DesiredTime 1=0) Time=0; 



** Page 2-10 ** 
** SACS . c ** 
** ** 



End Of Main Event Loop. 



★ ★ 
★ ★ 






if (Test==Yes && DiscrepancyFound==No) 

{ 

CheckingPredictions ( ) ; 

TotalNumberO f Accesses ‘f=NuinberOf Accesses [Read] 

+NumberOfAccesses [Write] ; 



} 

/*if (TotalNumberOfAccesses>=11270) {Trace=Yes; Test=No; }*/ 

if (DiscrepancyFound==Yes) 

{ 

Pause () ; 

Trace=Yes; 

Test^No; 

DesiredTime=0; 

Time=0; 

} 

if (DiscrepancyFound==No && Test==No && Time!=0) 

{ 

DisplayRequestsBreakDown () ; 

RecordForMatlab ( ) / 

} 

FreeArrays ( ) ; 

rewind (DataFile) / 

EndOfDataFile=No; 



if (KeyBoardIO==No) CloseDataFile () ; 



return (0) ; 






SACS . C 
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LoadArguments ** 

★ ★ 

Description: ** 

★ ★ 

LoadArguments takes the argument list argv and changes the ** 

user defined global variables (See Page 2-3) . ** 






i LoadArguments (argc, argv) 

.nt argc; 

:har *argv [ ] ; 



-nt i, j ; 

:or (i=l; i<argc; i++) 

{ 

if ( ! (strcmp (argv [i] , "-cs" 
CacheSize 

if ( ! (strcmp (argv [i] , "-bs" 
BlockSize 

if ( ! (strcmp (argv [i] , "-sbs" 
SubBlockSize 

if ( ! (strcmp (argv [i] , "-a" 
Associativity 
if ( ! (strcmp (argv [i] , "-ws" 
WordSize 

if ( ! (strcmp (argv [i] , "-rcat " 
Re adCa ch e A c ce s s T ime 
if ( 1 (strcmp (argv [i] , "-rcht" 
ReadCacheHitTime 
if (1 (strcmp (argv [i] , "-rcmt " 
Re adCa ch eMi s s T ime 
if ( ! (strcmp (argv [i] , "-wcat " 
WriteCacheAccessTime 
if ( 1 (strcmp (argv [i] , "-wcht " 
Writ eCacheH it Time 
if ( ! (strcmp (argv [i] , "-want " 
WriteCacheMissTime 

if ( ! (strcmp (argv [i] , "-mat" 
Memo ryAccessT ime 
if ( ! (strcmp (argv [i] , "-mtt" 
MemoryTrans f erTime 
if ( ! (strcmp (argv [i] , "-beat" 
Buf ferCacheAccessTime 

if ( ! (strcmp (argv [i] , "-rbs" 
ReadBuf ferSize 
if (! (strcmp (argv [i] , "-wbs" 
Wr it eBuf ferSize 



))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) / 
))) 

= ScanArgument (argv [++i] ) ; 
))) 

= ScanArgument (argv [++i] ) ; 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-** 

** Page 2-12 ** 
** SACS . c ** 
** ** 



★ ★ 
★ ★ 
★ ★ 



LoadArgumen t s 
Continued 



★ ★ 
★ ★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-***** 



if ( ! (strcmp (argv [i] , "-brp") ) ) 

{ 

BlockReplacementPolicy=-l; 

for ( j=0; j<NumberOfReplacementPoliciesAvailable; j++) 

i 

if ( ! (strcmp (argv [i ] , ReplacementPolicyString [ j ] ) ) ) 
BlockReplacementPolicy= j ; 

} 

if (BlockReplacementPolicy<0) 

{ 

printf (" Invalid Block Replacement Policy 1 '); 
exit (1) ; 

} 



if ( l (strcmp (argv[i] , ”-wp") ) ) 

{ 

WritePolicy=-l; 

for (j=0; j<NumberOfWritePoliciesAvailable; j++) 

{ 

if ( [ (strcmp (argv [i] , WritePolicyString [ j ] ) ) ) 
WritePolicy= j ; 

} 

if (WritePolicy<0) 

{ 

printf ("Invalid Write Policy"); 
exit (1) ; 

> 



if ( ! (strcmp (argv [i] , "-wmp" ) ) ) 

{ 

WriteMissPolicy=-l; 

for (j=0; j<NumberOfWriteMissPoliciesAvailable; j++) 

if (1 (strcmp (argv [i] , WriteMissPolicyString [ j ] ) ) ) 
WriteMissPolicy= j ; 

} 

if (WriteMissPolicy<0) 

{ 

printf (" Invalid Write Miss Policy”); 
exit (1) ; 

} 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-* 
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LoadArgnment s 
Continued 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-* 
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★ ★ 
★ ★ 
★ ★ 
★ ★ 



if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 



(strcmp (argv [i] , 
(strcmp (argv [i] , 
(strcmp (argv [i] , 
(strcmp (argv[i] , 
(strcmp (argv [i] , 
(strcmp (argv [i] , 
(strcmp (argv [i] , 
(strcmp (argv [i] , 
(strcmp (argv [i] , 
(strcmp (argv [i] , 
(strcmp (argv [i] , 
(strcmp (argv [i] , 



-rf " ) ) ) 

"drf ” ))) 

-cwfcw" ) ) ) 
-dcwf cw") ) ) 
-sbb" 



-dsbb" 

-urb 1 ' 

-durb" 

-rrd” 

-drrd" 

-rwd" 

-drwd" 



if ( ! (strcmp (argv [i] , "-rpr" 
ReadPriority 

if ( ! (strcmp (argv [i] , ”-wpr" 
WritePriority 



))) 

))) 

))) 

))) 

))) 

))) 

))) 

))) 

))) 

))) 



if ( ! (strcmp (argv [i] , "-rfwapr" ) ) ) 
ReadForWriteAllocatePriority = 



ReadForward = Yes; 

ReadForward = No; 

CPUWaitsForCacheWrites = Yes; 

CPUWaitsForCacheWrites = No; 

SearchBlockBuf fer = Yes; 

SearchBlockBuf f er = No; 

UpdateReadBuf f er = Yes; 

UpdateReadBuf fer = No; 

RemoveReadDuplicates = Yes; 

RemoveReadDuplicates = No; 

RemoveWriteDuplicates = Yes; 

RemoveWriteDuplicates = No; 



ScanArgument (argv [++i] ) ; 
ScanArgument (argv [++i] ) ; 

ScanArgument (argv[++i] ) ; 



if ( ! (strcmp (argv [ i ] , "-wdbpr" ))) 
WriteDirtyBlockPriority 

if (! (strcmp (argv[i] , "-npr” ))) 
WriteDirtyBlockPriority 



= ScanArgument (argv [++i] ) ; 



= ScanArgument (argv[++i] ) ; 



if ( 
if ( 
if ( 
if ( 
if ( 



(strcmp (argv [i] , ”-t " 
(strcmp (argv [i] , ”-dt " 
(strcmp (argv [i] , "-c" 
(strcmp (argv [i] ^ "-dc" 
(strcmp (argv [i] , "-test 1 



if ( l (strcmp (argv [i] , "-kbio" 
if ( l (strcmp (argv [i] , M -fio” 
if ( 1 (strcmp (argv [i] , ”-f ” 

if ( ! (strcmp (argv [i] , "-shmi" 
ScreenHistogramMaxIndex 
if ( 1 (strcmp (argv[i] , ”-fhmi" 
FileHistogramMaxIndex 



))) 

))) 

))) 

))) 

))) 

))) 

))) 

))) 

))) 

))) 



Trace 

Trace 

Check 

Check 

Test 

KeyBoardIO 

KeyBoardIO 

DataFileName 



= Yes; 

= No; 

= Yes; 

= No; 

= Yes; 

= Yes; 

= No; 

= argv [++i] ; 



= ScanArgument (argv [++i] ) ; 
ScanArgument (argv[++i] ) ; 






'★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A-* 
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ScanArgument 



★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ * 

** ScanArgument scans the input string for an unsigned long int, 

** if one is not found an error is raised. 



Description : 



★ ★ 
★ ★ 
★ ★ 
★ * 



★ ★ 

★ ★ ★ ★ 



unsigned long int ScanArgument (Argument ) 
char * Argument; 



unsigned long int Temp; 

if (sscanf (Argument, "%U" , &Temp) !=1) 

{ 

pnntf ("Error unsigned integer expected [ % s ] Argument) ; 

} ; 

return (Temp) ; 

} 



Initial izeProgrammersGlobalVariables 



/escription : 

InitializeProgrammersGlobalVariables takes the user defined global 
ariables and calculates programmer defined global variables, which are 
constant, once the input paramaters are determined, and reinitializes 
he global variables what will change. 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A- 



Initial izeProgrammersGlobalVariables () 



I me 



1 ; 



cheWait ingFor 
moryWaitingFor 
ockWait ingFor 
. screpancyFound 



Nothing; 

Nothing; 

Nothing; 

No; 



! cheHit 
i.fferHit 
; cheBusy 



Unknown; 

Unknown; 

No; 



: quest 

I.stRequest 

iquestAddress 

iquestBlockNumber 

iquestSize 

: questBlockNumber 

j meOfNextRequest 



None; 

None; 



0 / 

0 ; 

0 ; 

0 ; 

0 ; 



: mberOfBlocks 
‘mberOfSubBlocks 
J mberOfSets 



Cache Si ze/BlockSize; 
BlockSize/SubBlockSize; 
NumberOf Blocks /Associativity; 



; talNumberOfWordsReadFromMemory = 0; 
1 talNumberOfWordsWrittenToMemory = 0; 
3 talNumberOf Words Writ tenToCache = 0; 



E adsLeftForBlock 
E adsLeftForRequest 
i itesLeftForBlock 
fr itesLeftForRequest 



0 / 

0 ; 

0 ; 

0 ; 




0 ; 

0 ; 

0 ; 

0 ; 



l ockTOA 



No; 



l dOfDataFile 



★ ★ 

SACS . C 

Initial! zeBuf fers 
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★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 



Description : 



** InitializeBuf fers places the buffers in an empty state, with 

** their Max values set to the appropriate size. 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ 

★ ★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A-* 



void InitializeBuf fers () 



{ 

ReadBuf fer .Full = 
ReadBuffer .Empty = 
ReadBuf fer .Next = 

WriteBuffer 
BlockBuffer = 

ReadBuf fer .Max 
WriteBuffer .Max 
BlockBuffer .Max = 



No; 

Yes; 

0 ; 

ReadBuffer; 

ReadBuffer; 

ReadBuf fer Size- 1; 
WriteBuf ferSize-1; 
0 ; 



ReadBuf fer .Wait ingForFlag 
WriteBuf fer .Wait ingForFlag 
BlockBuffer .Wait ingForFlag 



CacheWaitingForFullReadBuf fer; 
CacheWaitingForFullWriteBuf fer; 
Nothing; 



} 






SACS . c 

DefineArrays 

Description: 

DefineArrays assigns memory to the array pointers. 
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★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 

>*/ 



;1 DefineArrays ( ) 



:acheBlockAddress 

.astCacheBloclcAccessTime 

lacheNextBlock 

2acheValidBit 

:acheDirtyBit 

lequestTimeHistogram 

JtallTimeHistogram 

?otalRequestTime 
:otalStallTime 
lumberOf Accesses 
lumberOf CacheHits 
JumberOfBuf ferHits 
'r edict edNumberOf Accesses 



= (Address Type*) 

DefineArraylD (NumberOf Blocks, 

sizeof (AddressType) ) ; 

= (TimeType*) 

DefineArraylD (NumberOf Blocks , 

sizeof (TimeType) ) ; 

= (SizeType*) 

DefineArraylD (NumberOf Sets, 

sizeof (SizeType) ) ; 

= (YesNoType**) 

Def ineArray2D (NumberOfBlocks, 

NumberOf SubBlocks, 
sizeof (YesNoType) ) ; 

= (YesNoType**) 

Def ineArray2D (NumberOfBlocks, 

NumberOf SubBlocks, 
sizeof (YesNoType) ) ; 

= (TimeType**) 

Def ineArray2D (NumberOf RequestsAvailable, 
FileHistogramMaxIndex, 
sizeof (TimeType) ) ; 

= (TimeType**) 

Def ineArray2D (NumberOf CacheWaitingFors Available, 
FileHistogramMaxIndex, 
sizeof (TimeType) ) ; 

= (TimeType*) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (TimeType) ) ; 

= (TimeType*) 

DefineArraylD (NumberOf CacheWait ingForsAvailable, 
sizeof (TimeType) ) ; 

= (ScoreType* ) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (ScoreType) ) ; 

= (ScoreType* ) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (ScoreType) ) ; 

= (ScoreType* ) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (ScoreType) ) ; 

= (ScoreType* ) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (ScoreType) ) ; 

= (ScoreType* ) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (ScoreType) ) ; 



'redictedNumberOfHits 
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* * SACS . c * * 

★ ★ ★ ★ 



FreeArrays 



★ ★ 



** Description: 



★ ★ 
★ ★ 



★ ★ 

★ * 

** H\r nof -i npArr^VQ ★★ 

★ ★ ★ ★ 



FreeArrays deallocates the memory assigned to the array points ** 

by Def ineArrays . 



void FreeArrays () 



{ 

char c; 

FreeArraylD (CacheBlockAddress, 
FreeArraylD (LastCacheBlockAccessTime, 
FreeArraylD (CacheNextBlock, 
FreeArray2D (CacheValidBit , 

FreeArray2D (CacheDirtyBit , 

FreeArray2D (RequestTimeHistogram, 

FreeArray2D (StallTimeHistogram, 



FreeArraylD (TotalRequestTime, 
FreeArraylD (TotalStallTime, 



NumberOfBlocks) ; 

NumberOfBlocks) ; 

NumberOfSets) ; 

NumberOfBlocks, NumberOfSubBlocks) ; 
NumberOfBlocks, NumberOfSubBlocks) ; 

NumberOfRequestsAvailable, 
FileHistogramMaxIndex) ; 
NumberOfCacheWaitingForsAvailable, 
FileHistogramMaxIndex) ; 

NumberOfRequestsAvailable) ; 

NumberOf CacheWait ingForsAvailable ) ; 



FreeArraylD (NumberOfAccesses, NumberOfRequestsAvailable) ; 
FreeArraylD (NumberOfCacheHits, NumberOfRequestsAvailable) ; 
FreeArraylD (NumberOfBuf ferHits, NumberOfRequestsAvailable) ; 
FreeArraylD (PredictedNumberOfAccesses, NumberOfRequestsAvailable) ; 

FreeArraylD (PredictedNumberOfHits, NumberOfRequestsAvailable) ; 



} 






SACS . C 

OpenDataFile 
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★ ★ 

★ ★ 
★ ★ 
★ ★ 



)escription: ** 

★ ★ 

OpenDataFile opens the file specified by DataFileName for ** 

eading. This becomes the data file that GetNextFileRequest reads ** 

:rom. ** 

★ ★ 



OpenDataFile () 



: (Test==No) 

{ 

if ( (DataFile=fopen (DataFileName, "r") )==NULL) 

{ 

printf ("Cannot open %s file" , DataFileName) ; 
exit (0) ; 

) 

> 

■ se 

j { 

if ( (DataFile=fopen (DataFileName, "w+" ) ) ==NULL) 

{ 

printf ("Cannot open %s file", DataFileName) ; 
exit (0) ; 

} 
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★ ★ 



** Description: 
★ ★ 

★ ★ 

★ ★ 



SACS . C 

CloseDataFile 



CloseDataFile closes the data file that OpenDataFile opened. 



★ ★ 
★ ★ 
* * 
★ ★ 
★ ★ 
■k ★ 
* * 






void CloseDataFile () 

{ 

fclose (DataFile) ; 

} 



r ************************************************************************** 



SACS . C 

PauseForCommand 
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★ ★ 

★ ★ 
★ ★ 



Description: ** 

* * 

PauseForCommand controles the displays. It takes input for the ** 

keyboard to determan which display to provide. It also adjusts the ** 

global variable Desired Time based on and "G #" commands. ** 

★ ★ 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■a-* j 



I PauseForCommand ( ) 



itatic char LastDisplayMode=' ' ; 

:har Inputstring [255] , 

*TmpStringPt, 

CommandChar, 

DisplayMode=' ' ; 

,nt Index; 

’imeType TmpTime; 

,f (Trace==Yes) LastDisplayMode=' t' ; else LastDisplayMode=' r' ; 

-hile (DisplayModel=LastDisplayMode) 

K 

if (DisplayMode!=' ') LastDisplayMode=DisplayMode; 
DisplayMode=LastDisplayMode; 

if (LastDisplayMode=«' t' ) DisplayTrace () ; 
if (LastDisplayMode==' r' ) DisplayRequestsBreakDown () ; 
if (LastDisplayMode==' s' ) DisplayStallHistogram( ) ; 
if (LastDisplayMode==' c' ) DisplayCacheArguments () ; 
if (LastDisplayMode==' h' ) DisplayHelpO; 

print f ("\nNext Command Please [ T, R, S, C, G #, #, -#, Help] >>>"); 

Index=-1; 

do 

{ 

Index++; 

scanf ("he", & Input St ring [Index] ) ; 

] 

while (Inputstring [Index] ! \n' ) ; 

while (InputString[0]==' ') 

for (lndex=0; Inputstring [ Index] !=' \n' ; Index++) 

Input String [ Index] =InputString [ Index+1 ] ; 

CommandChar=InputString [ 0 ] ; 

if (CommandChar>=' A' && CommandChar<=' Z' ) CommandChar+= (' a' A' ) ; 




★ ★ 






★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
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SACS . c ** 

★ ★ 

PauseForCommand ** 

continued , ** 

★ ★ 

r******'*-*****'*-*--*--*--*-*-*-***********'**'*****-*-*-*-*-*-*-*-** ! 



if (sscanf (Inputstring, "%U", &TmpTime) ==1 && CommandChar l =' \n' ) 

{ 

DesiredTime=Time+TmpTime; 

Trace=No; 

} 

if ( CommandChar ==' ) 

{ 

TmpStringPt=InputStrmg; 

TmpStringPt++; 

if (sscanf (TmpStringPt, " %U" , &TmpTime) ==1) DesiredTime=Time-TmpTime; 
Trace=No; 

} 

if (CommandChar==' g' ) 

{ 

TmpStringPt=InputString; 

TmpStringPt++; 

if (sscanf (TmpStringPt, "%U H , &TmpTime) ==1 ) DesiredTime=TmpTime; 
Trace=No; 

1 



if 

if 

if 

if 

if 

if 



( CommandChar ==' t' ) 
( Comma ndChar==' r' ) 
(CommandChar==' s' ) 
(CommandChar==' c' ) 
(CommandChar==' h' ) 
(CommandChar==' q' ) 



DisplayMode=' t' ; 
DisplayMode=' r' ; 
DisplayMode=' s' ; 
DisplayMode=' c' ; 
DisplayMode=' h' ; 
exit (0) ; 



} 



> 
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SACS . c 
Pause 



Description: 

Waiting for a character to be entered in. 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A: 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
■*■ ★ 
★ * 
★ ★ 
*★ 
* ★ 

**/ 



Pause 0 



har InputCharacter; 

rintf("\nHit the return key to Continue:"); 



{ 

scanf ("%c", & InputCharacter) ; 

} 

hile (InputCharacter !=' \n' ) ; 



f »t 



I 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★it* 



★ ★ 

** Global. h 

★ ★ 

** Part Of SACS 1.0 

** (StillAnother Cache Simulator) 

★ ★ 

** Program Modified: 3/17/94 

** File Modified: 3/17/94 

★ ★ 

** Author: William G. Smith 

** Address: Electrical Engineering Department 

** Naval Postgraduate School 

** Monterey, CA 93940 

★ ★ 
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★ ★ 

★ ★ 
★ ★ 
★ ★ 
* * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



** Copyright 1994, William G. Smith 
★ ★ 



★ ★ 
★ ★ 



★ ★ 
★ ★ 
★ ★ 
-*■ * 
★ ★ 
★ ★ 
★ -*■ 
★ ★ 
★ ★ 
★ ★ 
★ * 



Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 

This program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
user . 



+ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



***★★***★★★★★**★★*★*★★★★*★★★★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-it* j 



***★★★★★**★*★★***★*★*★★*****★*★★****★********★***★****★*******★★★*★**★**•*•* 



Global .h 
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Global Variables Used by SACS Packages ** 

★ * 

pescription: ** 

★ ★ 

Global. h is the only include file needed by all of the SACS source ** 
files. It contains all the global variables, both user and programmer ** 
defined variables. The user defined variables represent all the input ** 
parameters. The programmer defined variables represent all global ** 

variables that are shared between all the SACS source code files, that ** 
the user does not have access to. ** 



SACS . c defines all of the initial values of the global variables 
;herefore, does not include Global. h 

Table of Contents 



★ ★ 
★ ★ 
★ ★ 
★ ★ 






Page 


3- 


1 


★ ★ 


Page 


3- 


2 


* ★ 


Page 


3- 


3 


★ ★ 
* * 


r * * * * 


*****★★***★*★★ 


***/ 



ilef GLOBAL. H 

..ne GLOBAL . H 

>.ude <stdlib.h> 
i.ude <stdio.h> 

t.ude 11 SACS . h" 
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** Global. h ** 
** ★★ 
** User Defined Global Variables ** 
** Description: ** 
** *★ 

** These variables represent the programs input parameters. ** 
* * ★* 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■a-****.*.*.*..*..*.*.*..*..*..*.*..*. 



extern 


CacheSizeType 


extern 


SizeType 


extern 


SizeType 


extern 


AssociativityType 


extern 


SizeType 


extern 


Time Type 


extern 


Time Type 


extern 


TimeType 


extern 


Time Type 


extern 


TimeType 


extern 


TimeType 


extern 


TimeType 


extern 


TimeType 


extern 


TimeType 


extern 


Buf fer SizeType 


extern 


Buf fer SizeType 


extern 


BlockReplacementPolicyType 


extern 


WntePolicyType 


extern 


WriteMissPolicyType 


extern 


YesNoType 


extern 


YesNoType 


extern 


YesNoType 


extern 


YesNoType 


extern 


YesNoType 


extern 


YesNoType 


extern 


PriorityType 


extern 


PriorityType 


extern 


PriorityType 


extern 


PriorityType 


extern 


PriorityType 


extern 


YesNoType 


extern 


YesNoType 


extern 


YesNoType 


extern 


YesNoType 


extern 


char 


extern 


HistogramlndexType 


extern 


HistogramlndexType 



CacheSize; 

BlockSize; 

SubBlockSize; 

Associativity; 

WordSize; 

ReadCacheAcces sTime ; 

ReadCa ch eH i t T ime ; 

ReadCa cheMi s sTime ; 
WriteCacheAccessTime; 

Writ eCacheHit Time ; 
WriteCacheMissTime; 

MemoryAccessTime; 

MemoryTrans f erTime ; 

Buf ferCacheAcces sTime; 

ReadBufferSize; 

WriteBufferSize; 

BlockReplacementPolicy; 

WritePolicy; 

WriteMissPolicy; 

ReadForward; 
CPUWaitsForCacheWrit es ; 
SearchBlockBuf fer; 

Updat eReadBu f f er ; 

Remo veReadDupl i cat e s ; 
RemoveWriteDuplicates; 

ReadPriority; 

WritePriority; 

ReadForWriteAllocatePriority; 

WriteDirtyBlockPriority; 

NoPnority; 

Trace; 

Check; 

Test ; 

KeyBoardIO; 

*DataFileName ; 

ScreenHistogramMaxIndex; 

FileHistogramMaxIndex; 



Global. h 
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★ ★ 



Programmer Defined Global Variables ** 

★ ★ 

rn Time Type Time; 

,rn TimeType DesiredTime; 

.rn CacheWaitingForType CacheWaitingFor; 

;rn MemoryWaitingForType MemoryWaitingFor; 

.rn BlockWaitingForType BlockWaitingFor; 

.rn YesNoType DiscrepancyFound; 



.rn YesNoType 
.rn YesNoType 
.rn YesNoType 

.rn RequestType 
.rn RequestType 
.rn AddressType 
.rn SizeType 
.rn SizeType 
.rn TimeType 



CacheHit ; 

Buf ferHit ; 
CacheBusy; 

Request; 

LastRequest ; 
RequestAddress; 
RequestSize; 
RequestBlockNumber; 
TimeOfNextReques t ; 



.rn SizeType NumberOf Blocks; 

.rn SizeType NumberOf SubBlocks; 

.rn SizeType NumberOf Sets; 



.rn AddressType 
.rn TimeType 
.rn SizeType 
.rn YesNoType 
.rn YesNoType 



♦CacheBlockAddress; /♦ 
♦LastCacheBlockAccessTime; 
♦CacheNextBlock; /* 
♦♦CacheValidBit; /* 
**CacheDirtyBit; /* 



[NumberOfBlocks ] 

[NumberOf Sets] 
[NumberOfBlocks ] 
[NumberOf SubBlocks ] 



*/ 

*/ 
*/ 
* / 



.rn TimeType 

.rn TimeType 

rn TimeType 
rn TimeType 
rn ScoreType 
rn ScoreType 
rn ScoreType 
rn ScoreType 
rn ScoreType 
rn ScoreType 



**RequestTimeHistogram; /* 



/* 

**StallTimeHistogram; /* 

/* 

*TotalRequestTime; /* 

*TotalStallTime; /* 

♦NumberOf Accesses ; / * 

♦NumberOfCacheHits ; 
♦NumberOf Buf ferHit s; 



♦PredictedNumberOf Accesses; 

♦PredictedNumberOfHits; 

TotalNumberOfAccesses; 



[NumberOf Requests Available] */ 
[FileHistgramMax Index] ♦/ 
[NumberOfCacheWait ingForsAv] */ 
[FileHistgramMaxIndex] */ 
[NumberOf Request sAvailable] ♦/ 
[NumberOf StallsAvailable] ♦/ 
[NumberOfRequestsAvailable] ♦/ 



:rn ScoreType TotalNumberOfWordsReadFromMemory; 

:rn ScoreType TotalNumberOfWordsWrittenToMemory; 

:rn ScoreType TotalNumberOfWordsWrittenToCache; 



:rn Buf ferType ReadBuffer; 

:rn Buf ferType WriteBuffer; 

:rn Buf ferType BlockBuffer; 



:rn AddressType 
:rn TimeType 
: rn TimeType 
:rn TimeType 



MAR; 

TOA; 

TOD; 

BlockTOA; 



:rn FILE *DataFile; 

VocWATtmo F.nHOfnpt 1 q : 



★ ★ 



Global .h 
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★ ★ 
★ ★ 
★ ★ 




Programer Defined Global Variables 
continued 

Enumerator Strings 



★ ★ 




★ ★ ★ ★ 
★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-a-* i 



extern char 

*YesNoString [ ] , 
*RequestString [ ] , 
*ReplacementPolicyString [ ] , 
*WritePolicyString [ ] , 
*WriteMissPolicyString [ ] , 



/* [2] V 
/* [NumberOfRequestsAvailable] */ 
/* [ReplacementPolicvString] */ 
/* [NumberOfWritePoliciesAvailable] */ 



/* [NumberOfWriteMi^PoliciesAvailable] V 



*CacheWaitingForString [ ] , /* 
*MemoryWaitingForString [] , /* 
*BlockWaitingForString [ ] ; /* 



[NumberOfCacheWaitingForsAvailable] */ 
[NumberOfMemoryWaitingForsAvailable] */ 
[NumberOfBlockWaitingForsAvailable ] * / 



#endif 



rir+irir-kir-k* + irir + + + + * + + + + + * + + + + + + + + + + + + + +**+ + + + ++ + + ir + iric+'* + 'irir+irir'ir'it + -k'ir'i''ieirir-k'k + -kir 



Cache . c 
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Part Of SACS 1.0 
(StillAnother Cache Simulator) 

Program Modified: 3/17/94 
File Modified: 3/17/94 

Author: William G. Smith 

Address: Electrical Engineering Department 

Naval Postgraduate School 
Monterey, CA 93940 

Copyright 1994, William G. Smith 

Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 

This program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
user. 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



★ ★ 
★ ★ 
★ + 
★ ★ 
★ ★ 
★ ★ 
★ ★ 






/* i 
★ * 



r**************i 



t***************************i 



r****************i 



Cache . c 
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★ * 
★ ★ 
★ ★ 
★ * 
★ * 
* * 
★ * 



* * 
* ★ 



★ * 
★ * 



★ * 
★ * 
★ ★ 
★ * 
★ ★ 
★ * 
* * 
★ * 
* ★ 
★ ★ 
★ * 
★ ★ 



Description : 

CacheModel makes all the necessary calls to simulate cache memory. 
CacheModel decides which calls to make, based on the value of CacheHit, 
and Request. This function is called every time Time is incremented. 

If there are no read or write requests waiting to be completed the 
function does nothing. The value of CacheHit will remain Unknown until 
the appropriate cache access time has expired. Then CacheModel will 
call IsRequestAHit to determine if the request is a hit or a miss. 

Table of Contents 



Cover Page 

List of Cache. c Function Declarations 



★ ★ 
★ * 
★ * 
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★ ★ 
★ ★ 


r**********i 


*********** j 



# include 



Global .h 



Cache . c 
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★ * 



List of Cache. c Function Declarations ** 

★ ★ 

)escription: ** 

★ ★ 

This is a list of function declarations within the file scope ** 

jf "Cache. c". ** 

★ ★ 



CacheModel () ; 


/* 


Page 


4- 3 


*/ 


IsRequestAHit 0 ; 


/* 


Page 


4- 4 


*/ 


ReadHit () ; 


/* 


Page 


4- 5 


*/ 


ReadMiss () ; 


/* 


Page 


4- 6 


*/ 


WriteHit ( ) ; 


/* 


Page 


4- 7 


*/ 


WriteMiss () ; 


/* 


Page 


4- 8 


*/ 


AccessCache () ; 


/* 


Page 


4-10 


*/ 


SelectBlockVictimO ; 


/* 


Page 


i — i 
i — i 

l 


*/ 


SetDirtyBits ( ) ; 


/* 


Page 


4-13 


* / 


WriteDirtySubBlocks () ; 


/* 


Page 


4-14 


*/ 


AddToReadBuf fer () ; 


/* 


Page 


4-16 


*/ 


Type SearchCache ( ) ; 


/* 


Page 


4-20 


*/ 


AddToWriteBuf f er ( ) ; 


/* 


Page 


i — i 

CM 

1 


*/ 
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★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 
* * 
* ★ 
★ ★ 
* * 
* * 
★ * 
★ ★ 



Cache . c 
CacheModel 



Description : 



CacheModel makes all the necessary calls to simulate cache memory . 
CacheModel decides which calls to make, based on the value of CacheHit, 
and Request. This function is called every time Time is incremented. 

If there are no read or write requests waiting to be completed the 
function does nothing. The value of CacheHit will remain Unknown until 
the appropriate cache access time has expired. Then CacheModel will 
call IsRequestAHit to determine if the request is a hit or a miss. 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 






void CacheModel () 



{ 



if (CacheHit==Unknown && Request 1 =None) 

{ 

if (Request==Read ) 

AccessCache (ReadCacheAccessTime, CacheWaitingForReadCacheRequest ) ; 
if (Request ==Write) 

AccessCache (WriteCacheAccessTime, CacheWaitingForWriteCacheRequest ) ; 
if (CacheWaitingFor==Nothing) IsRequestAHit () ; 

} 



if 

if 

if 

if 



(CacheHit==Yes && 
(CacheHit==No && 
(CacheHit==Yes && 
(CacheHit==No && 



Request-Read ) 
Request==Read ) 
Request==Write) 
Reque s t ==Wr i t e ) 



ReadHit () ; 
ReadMiss () ; 
WriteHit () ; 
WriteMiss () ; 



} 
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IsRequestAHit 



•escnption: ** 

★ ★ 

IsRequestAHit determines if the request is a hit or a miss, and ** 

ets CacheHit to the appropriate value. IsRequestAHit will find the ** 

etNumber that the data is supposed to be in. Then all ** 

'acheBlockAddresses in that set will be checked to see if they equal ** 
he BlockAddress for that request. If the correct block is found, ** 

hen all sub blocks that are required to satisfy the request will be ** 

nspected for validity. If all required sub blocks are valid then ** 

acheHit will equal Yes on return from IsRequestAHit. ** 

★ ★ 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ j 



IsRequestAHit () 



zeType SetNumber = Set (RequestAddress) ; 

zeType FirstBlock = SetNumber*Associativity; 

.zeType LastBlock = FirstBlock+Associativity~l; 

zeType Blocklndex; 

zeType SubBlock Index; 

: cheHit=No; 

\ f ferHit=Unknown; 

I r (BlockIndex=FirstBlock; BlockIndex<=LastBlock; BlockIndex++) 

I 

if (CacheBlockAddress [Blocklndex] ==BlockAddress (RequestAddress) ) 

{ 

CacheHit=Yes; 
if (Request==Read) 

{ 

for (SubBlockIndex=SubBlock (RequestAddress) ; 

SubBlockIndex<=SubBlock (RequestAddress+RequestSize-1) ; 
SubBlockIndex++) 

if (CacheValidBit [Blocklndex] [SubBlocklndex] ==No) CacheHit=No; 

} 

LastCacheBlockAccessTime [Blocklndex] =Time; 

} 

} 

J (CacheHit==Yes) Buf ferHit=No; 



) 






★ ★ 
★ ★ 
★ ★ 
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★ ★ 

★ ★ 
★ ★ 
★ ★ 



Description : 



*• ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 



ReadHit is called to simulate a cache hit during a read request. 
Read Hit simply finishes simulating the cache access for the hit. 
ReadCachHitTime is the time required to send the data from the cache 
to the CPU. Note that the Ttime to locate the block in the cache is 
simulated in CacheModel . ReadHit is called repeatedly while Time is 
incremented until Access Cache returns with CacheWaitingFor equal to 
Nothing. AccessCache will return CacheWaitingFor equal to 
ReadCacheRequest until the ReadCacheHitTime has expired. 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•a-**** 



void ReadHit () 



AccessCache (ReadCacheHitTime, CacheWaitingForReadCacheRequest ) ; 

} 
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ReadMiss 

Description : 

ReadMiss is called to simulate a cache miss during a read request. 
ReadMiss first simulates the time it would take to perform all block 
nanagement for a read miss. This time is called Read Cache Miss Time. 
Dnce that time has passed Read Miss calls Select Block Victim to pick a 
olock in the set. When SelectBlockVictim returns with CacheWaitingFor 
squal to Nothing the Request Block Number will contain the new block 
“lumber where the data will be placed. 

Once the new block has been chosen, ReadMiss will call 
\ddToReadBuf fer . If ReadForward is selected, then RequiredSize for the 
nemory request will be equal BlockSize. The RequiredSize in the read 
nemory request tells the MemoryModel how much of the requested data 
nust be read into the BlockBuffer before resetting Cache WaitingFor 
oack to Nothing. By setting RequiredSize equal to BlockSize, Read Miss 
ls forcing Memory Model to read in the entire block before setting 
Zache aiting For back to Nothing. Once the Memory Model has read in 
:he data, it is assumed to be able to the CPU during that clock cycle. 



ReadMiss () 



zcessC ache (ReadCacheMissTime, CacheWaitingForReadCacheRequest ) ; 

E (CacheWaitingFor==Nothing | | 

CacheWaitingFor==CacheWaitingForFullWriteBuf fer) 

SelectBlockVictim () ; 

E (CacheWait ingFor==Nothing | | 

CacheWaitingFor==CacheWaitingForFullReadBuf fer) 

{ 

if (ReadForward==Yes ) 

AddToReadBuf fer (RequestAddress, 

BlockSize, 

RequestSize, 

RequestBlockNumber, 

ReadPriority) ; 

else 

AddToReadBuf fer (RequestAddress, 

BlockSize, 

BlockSize, 

RequestBlockNumber, 

ReadPriority) ; 

if (CacheWait ingFor==Nothing) 

CacheWait ingFor=CacheWaitingForReadMemoryRequest ; 

} 

iCordStall (CacheWaitingFor) ; 

: ( CacheWait ingFor==CacheWaitingForReadMemoryRequest && 
NoRequestsLeft (SReadBuf fer ) ) 

CacheWait ingFor=Nothing; 









★ ★ 
★ ★ 
* ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
* ★ 
★ ★ 
★ ★ 



★ ★ 

★ ★ 

★ ★ i 
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Description: 



WriteHit is called to simulate a cache hit during a write request. 
Write Hit will first simulate the time to write the data to the 
RequestBlockNumber in the cache. Note that the time tc locate the 
block was simulated by CacheModel. Once WriteCacheHitTime has expired 
then WriteHit will perform the block management for the request. The 
block management is dictated by the WritePolicy. For a WriteBack 
policy the sub blocks written to must have their dirty bits set. This 
is done by SetDirtyBit . For a WriteThrough policy the request must be 
set to the write buffer. This is done by AddToWriteBuf fer . ** 

* i 



★ ★ 
★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 



void WriteHit () 

{ 

AddressType TempAddress; 

AccessCache (WriteCacheHitTime, CacheWaitingForWriteCacheRequest ) ; 

if (CacheWaitingFor==Nothing | | 

CacheWaitingFor==CacheWaitingForFullWriteBuf fer) 

{ 

switch (WritePolicy) 

{ 

case WriteBack: 

{ 

SetDirtyBits () ; 
break; 

} 

case WriteThrough: 

{ 

for (TempAddress =SubBlockAddress (RequestAddress+SubBlockSize-1) ; 
TempAddress <SubBlockAddress (RequestAddress+RequestSize) ; 
TempAddress+=SubBlockSize) 

CacheValidBit [RequestBlockNumber] [SubBlock (TempAddress) ]=Yes; 
AddToWriteBuf fer (RequestAddress, RequestSize, WritePriority) ; 
break; 

} 

default : 

print f ("WritePolicy not defined for [WriteHit] procedure.”); 
exit (1) ; 




} 



t ★★★★★*★★★★★*******************•★★★★★★★★★*★★ + ★★*★★★★★★★★★★*★★★★★★■*•★★★*.*★*.■*..*. 
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WriteMiss 



★ ★ 
★ ★ 



•escript ion : 

WriteMiss is called to simulate a cache miss during a write 
*equest . WriteMiss will first simulate the time needed to perform 
11 block management requests. The time is called WriteCacheMissTime . 
his is only the time required to make the requests, not the time 
equired to complete the block management requests. The time to 
letermine that a miss occurred was simulated by CacheModel. Once the 
JriteCacheMissTime has expired, then WriteMiss will perform all block 
lanagement requests. The memory requests are dictated by the 
JriteMissPolicy . The simplest policy is WriteAround. For a 
friteAround policy the write data is placed in the WriteBuffer by 
bldToWriteBuf fer . WriteAllocate however, is the toughest simulation 
,n SACS. WriteMiss must first choose a block to put the new data in. 
’his is done by SelectBlockVictim. Then the block data not provided 
>y the write has to be read in. This read request is made by 
.ddToReadBuf fer . Because the read address is calculated by adding the 
equest size to the address. The new address may be in the next block 
;o to make the addition modulo the BlockSize may have to be subtracted, 
fhen the read request has been make then the sub blocks that were 
rritten to in there entirety will have there valid bits set. If only 
>art of a sub block was written to then the CacheValidBit will not be 
;et . 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
+ ★ 
* ★ 
★ ★ 
★ ★ 



WriteMiss then uses the WritePolicy to dictate how the write data ** 
.s to update the memory. For a WriteBack policy dirty bits are set by ** 
JetDirtyBits . For a WriteThough the data is added to the WriteBuffer ** 
>y AddToWriteBuf fer . ** 

★ ★ 






**/ 



c WriteMiss ( ) 



i LdressType Temp Addr ess; 

hcessCache (WriteCacheMissTime, CacheWaitingForWriteCacheRequest ) ; 

iritch (WriteMissPolicy) 

{ 

case WriteAround: 

{ 

if (CacheWaitingFor==Nothing | | 

CacheWaitingFor==CacheWaitingForFullWnteBuf fer) 
AddToWriteBuf fer (RequestAddress, RequestSize, WritePriority) ; 
break; 

} 

default : 

{ 

printf ("WriteMissPolicy not defined in [WriteMiss] procedure"); 
exit (1) ; 

> 



/★★★★★★★★★*★★★★★★★★★★*★★*****************************★★*★★★★*★★★★★*★★★★★★★*■★★■*■ 
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** ** 

** WriteMiss ** 



continued 






★ ★ 
★ * 

(■★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A - 1 



case WriteAllocate : 

{ 

if (CacheWaitingFor—Nothing | | 

CacheWaitingFor==CacheWaitingForFullWriteBuf fer ) 

SelectBlockVictimO ; 

if (CacheWaitingFor==Nothing | | 

CacheWaitingFor==CacheWaitingForFullReadBuf fer) 

{ 

if ( (BlockSize-RequestSize) >0) 

if (BlockAddress (RequestAddress+RequestSize) 

==BlockAddress (RequestAddress) ) 

AddToReadBuf fer (RequestAddress+RequestSize, 
BlockSize-RequestSize, 

0 , 

RequestBlockNumber, 
ReadForWriteAllocatePriority) ; 

else 

AddToReadBuf fer ( (RequestAddress+RequestSize) -BlockSize, 
BlockSize-RequestSize, 

0, 

RequestBlockNumber, 
ReadForWriteAllocatePriority) ; 

} 

if ( (CacheWaitingFor==Nothing | | 

CacheWaitmgFor==CacheWaitingForFullWriteBuf fer) && 
CacheBlockAddress [RequestBlockNumber] ==BlockAddress (RequestAddress) ) 
{ 

for (TempAddress =SubBlockAddress (RequestAddress+SubBlockSize-1) ; 
TempAddress <SubBlockAddress (RequestAddress+RequestSize) ; 
TempAddress+=SubBlockSize) 

CacheValidBit [RequestBlockNumber ] [SubBlock (TempAddress) ]=Yes; 

switch (WritePolicy) 

{ 

case WriteBack: 

SetDirtyBits ( ) ; 
break; 

case WriteThrough : 

AddToWriteBuf fer (RequestAddress, RequestSize, WritePriority) ; 
break; 
default : 

printf (’’WritePolicy not defined for [WriteMiss] procedure”); 
exit (1) ; 

} 



break; 

} 



} 



} 
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AccessCache 



ascription: 

AccessCache is called to simulate a the CPU accessing the cache. 
\ccessCache first waits for the cache not to be busy. The only reason 
L t could be busy is if the BlockBuffer is in the process of updating 
:he cache. During this time AccessCache will return CacheWaitingFor 
jqual to CPUCacheAccess . Once the cache is not busy then CacheBusy is 
>et to Yes locking out the BlockBuffer from accessing the cache. Then 
ZacheWaitingFor will set equal to WaitingForRequest this is a local 
variable passed by the caller. It will either be equal to 
leadCacheAccess, or WriteCacheAccess . Then CacheBusy is set for the 
:ime specified by RequestTime. RequestTime is a local variable. It 
;ould equal any of the hit, miss, or access times. Once RequestTime 
las expired then AccessCache will set CacheBusy equal to No, and 
ZacheWaiting For equal to Nothing. 



AccessCache (RequestTime, WaitingForRequest ) 

.meType RequestTime; 

icheWaitingForType WaitingForRequest; 



:.atic TimeType CacheTOA=0; 

(CacheBusy==Yes && CacheWaitingFor==Nothing ) 
CacheWaitingFor=CacheWait ingForCPUCacheAccess ; 

(CacheBusy==No && CacheWait ingFor==CacheWait ingForCPUCacheAccess) 
CacheWaitingFor=Nothing; 

(CacheWaitingFor==No thing) 

{ 

CacheBusy=Yes ; 

CacheWaitingFor=WaitingForRequest ; 

CacheTOA=Time+RequestTime; 

) 

RcordStall (CacheWaitingFor) ; 

: r (CacheTOA<=Time && CacheWaitingFor==WaitmgForRequest ) 

{ 

CacheBusy=No; 

CacheWaitmgFor=Nothing; 

} 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★*★★★★★★ 
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★ ★ * ★ 



** SelectBlockVictim 

★ ★ 

** Description: 

★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ * 



** SelectBlockVictim chooses the next block to ^e used, and writes 

** the dirty subblocks out to the WriteBuffer. Se tBlockVictim first 
+ * surveys the cache set that the RequestAddress m to. The servey 
** includes finding the block that was least recently accessed. This 
** BlockNumber is stored in LRUBlock. Once the set has been surveyed 
** then the ReplacementPolicy dictates how the block is chosen. For the 
** LRU policy Request Block Number is set equal to LRUBlock. For the 
** FIFO policy CacheNextBlock keeps track of the next victim block for 
** each set. CacheNextBlock is initialized to all zeros during the 
** beginning of a run. Therefore it must be checked to see if it is 
** between the first, and last blocks for the set. If it is not then 
** CacheNextBlock for SetNumber is reset to FirstBlock. Once 
** SelectBlockVictim knows it has a valid Cache Next Block then 
** RequestBlock is set equal to it. Then CacheNextBlock for the 
** SetNumber is incremented. For RAND policy the block number is chosen 

** randomly from all the blocks in the set 
★ ★ 

** SelectBlockVictim writes all dirty sub blocks to the WriteBuffer 

** using WriteDirtySubBlocks . WriteDirtySubBlocks takes care of clearing 
** the dirty and valid bits in the block. Once SelectBlockVictim is 
** called and it gets to the bottom of the function with Cache.. aitingFor 
** equal to Nothing then the CacheBlockAddress for the RequestBlockNumber 

** is set equal to the block address of RequestAddress. 

★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
•k ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★it j 



void SelectBlockVictimO 

< 



SizeType 

SizeType 

SizeType 

SizeType 

SizeType 



SetNumber 
FirstBlock 
LastBlock 
Blocklndex; 
SubBlo ck Index; 



Set (RequestAddress) ; 

SetNumber*Associativity; 

FirstBlock+Associativity-1; 



TimeType LRUTime = Time+1; 

SizeType LRUBlock; 
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SelectBlockVictim 

Continued 



*questBlockNumber=FirstBlock; 

)r (Bio ckIndex=First Block; BlockIndex<=LastBlock ; Block Index++) 

{ 

if (CacheBlockAddress [Blocklndex] “BlockAddress (RequestAddress) ) 
RequestBlockNumber=Block Index; 
if (LRUTime>LastCacheBlockAccessTime [Blocklndex] ) 

{ 

LRUTime^LastCacheBlockAccessTime [Blocklndex] ; 
LRUBlock=BlockIndex; 

} 



: (CacheBlockAddress [Request Bio ckNumber] 1 =BlockAddress (RequestAddress) ) 



switch (BlockReplacementPolicy) 

{ 



case LRU: 

RequestBlockNumber=LRUBlock; 

LastCacheBlockAccessTime [Req^aestBlockNumber ] =Time; 
break; 

case FIFO: 

if (CacheNextBlock [SetNumber] <FirstBlock | I 
CacheNextBlock [SetNumber] >LastBlock ) 
CacheNextBlock [SetNumber] =FirstBlock; 
RequestBlockNumber=CacheNextBlock [SetNumber ] ; 
if (ReqpjestBlockNumber<LastBlock) 

CacheNextBlock [SetNumber] ++; 
else 

CacheNextBlock [SetNumber] =FirstBlock; 
break; 



case RAND: 

RequestBlockNumber= (rand ( ) %Associat ivity) +FirstBlock; 
break; 



> 

WriteDirtySubBlocks () ; 

} 

(CacheWa itingFor==Nothing) 

CacheBlockAddress [RequestBlockNumber ] =BlockAddress (RequestAddress) ; 






** Page 4-13 ** 
** Cache. c ** 
* * * * 

** SetDirtyBits ** 
★ ★ ★★ 

** Description: ** 
* * *★ 

** SetDirtyBits sets the dirty bits for all sub blocks that contains ** 
** data that was modified by a write request. ** 
* * ★ * 






void SetDirtyBits ( ) 



SizeType SubBlocklndex; 

for ( SubBlockIndex=SubBlock (RequestAddress ) ; 

SubBlockIndex<=SubBlock (RequestAddress+Request Size-1 ) ; 
SubBlockIndex++) 

CacheDirtyBit [RequestBlockNumber ] [SubBlocklndex] =Yes; 



} 
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★ ★ 



★ ★ 

WriteDirtySubBlocks ** 

★ ★ 



escription: ** 

★ ★ 

WriteDirtySubBlocks is called to simulate writing all the dirty ** 
ub blocks in RequestBlock . WriteDirtySubBlocks not only clears all ** 
he dirty bits. It also clears all the valid bits. ** 

riteDirtySubBlocks prepares a block to receive new data, and is called ** 
fter a block has been selected as a victim. WriteDirtySubBlocks will ** 
earch the block for consecutive dirty blocks and splice them together ** 
nto one write request. The write request is then added to the ** 

riteBuffer. All of the sub blocks that make up the request will have ** 
heir dirty and valid bits cleared. This process of searching and ** 

riting is repeated until all the bits are not dirty. Then all the ** 

alid bits are cleared. ** 

★ ★ 

★ ★★★★★★★★★★★★★★★★★★★■******************* , ******** + ******************'*'**'*''*'*/ 



WriteDirtySubBlocks 0 



zeType i; 

zeType SubBlocklndex = 0; 



dressType 
; zeType 
iorityType 



MemoryRequest Address 

MemoryRequestSize 

MemoryRequestPriority 



CacheBlockAddress [RequestBlockNumber] ; 

0 ; 

WriteDirtyBlockPrionty; 



/★★★★★★★★★★★★★★★★★★★★★★★♦★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A-** 
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★ ★ ★ ★ 

** WriteDirtySubBlocks ** 
** continued ** 
★ ★ ★ ★ 






do 

{ 

MemoryRequestSize=0; 

while ( (CacheDirtyBit [RequestBlockNumber] [ SubBlocklndex] ==No I i 
CacheValidBit [RequestBlockNumber] [SubBlocklndex] ==No) && 
SubBlockIndex<NumberOf SubBlocks) 

SubBlockIndex++; 

MemoryRequestAddress=CacheBlockAddress [RequestBlockNumber] 

+SubBlock Index* SubBlockSize; 

while (CacheDirtyBit [RequestBlockNumber ] [SubBlocklndex] ==Yes && 
SubBlockIndex<NumberOf SubBlocks) 

{ 

MemoryRequestSize+=WordSize; 

SubBlockIndex++; 

} 

if (MemoryRequestSize) 

{ 

AddToWriteBuf fer (MemoryRequest Address, 

MemoryRequestSize, 

MemoryRequestPriority) ; 
if (CacheWaitingFor==No thing) 

for (i=0; i<=SubBlockIndex && i<NumberOf SubBlocks; i++) 
CacheDirtyBit [RequestBlockNumber] [i] =No; 

} 

} 

while (SubBlockIndex<NumberOf SubBlocks && CacheWaitmgFor==Nothing) ; 

if (CacheWaitingFor==Nothing) 

for (i=0; i<NumberOf SubBlocks; i++) 

CacheValidBit [RequestBlockNumber] [i]=No; 



} 
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AddToReadBuf f er 



Description: 

AddToReadBuf fer takes the elements of a request, and adds the 
request to the ReadBuffer. It will perform all of the searches, and 
updates necessary to support the appropriate scoreboarding protocals . 

AddToReadBuf fer will begin by searching the cache, and 
BlockBuffer for each byte in the request starting at the beginning of 
the request. Every time a byte is found in one or the other then the 
Address is incremented, while Size and RequiredSize are decremented. 
This simulates removing the available data from the front of the 
request. Then AddToReadBuf fer will search the cache, and BlockBuffer 
for the data at the end of the request. Every time a byte is found 
then the Size of the request is decremented by one. If the byte was a 
required byt then the RequiredSize is decremented also. This simulates 
removing any data available from the end of the request. 

AddToReadBuf fer is either left with a request that has a Size equal to 
zero or the end points are both needed from memory. If the RequiredSize 
is zero then the request is a buffer hit, otherwize the request is a 
buffer miss. If the request is already a cache hit then the buffer 
hit is for some block management request. These kinds of buffer hits 
are not recorded because it would confuse the ResultsDisplay, by making 
it possible to get a hit rate greater tha 100%. If the Size is not 
zero and Remove ReadDuplicates is eaual to No then the request is 
added to the end of the ReadBuffer using Append. Append is a buffer 
utility that adds the request to the end of the buffer. The request 
must be added to the end of the buffer in ouder not to interfere with 
MemoryModel which maybe in the middle of a memory read. If 
RemoveReadDuplicates is equal to Yes then the first byte in the request 
will be spliced into the Read Buffer. 

Splice is another buffer utility. Splice will first search the 
ReadBuffer for the byte if it cant't find a request in the buffer that 
contains the byte then it will search for a read request that is 
getting data from the same block. If one is found then the request is 
modified to include the new read byte request. If no suitable request 
can be found then Splice will add a one byt request to the Read Buffer. 
The Address is then incremented while the Size, and Required Size are 
decremented. Then the cache, and BlockBuffer are searched for the next 
byte. If it is not found then the next byte is spliced into the 
ReadBuffer. This process is repeated until all of the bytes of the 
request have either been spliced into the ReadBuffer or found. 

The BufferHit is normally defined as when the data is available 
but in the cache. However m order to support the testing of SACS, 
the definition of a buffer hit is redefined to mean that a request was 
found to have accrued recently, and that given time to complete all 
olock management the requested data would have been in the cache. 

This allows TestSACS to predict the hits of a test run without taking 
into account the time in takes to preform the block management. 

Every time a request is spliced into the read or write buffers 
then the TimeToExecute, and CompletionTimeExtamate must be 
recalculated. The new time estimates are performed by 
CalculateTimeEstimates . 
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★ ★ ★ ★ 

** AddToReadBuf fer ** 
** continued ** 
★ ★ * ★ 






void AddToReadBuf fer (Address, Size, RequiredSize, Block, Priority) 

AddressType Address ; 

SizeType Size; 

SizeType RequiredSize; 

SizeType Block; 

PriorityType Priority; 

{ 



MemoryRequestType ReadMemoryRequest ; 



YesNoType 
AddressType 
AddressType 
Buf ferSizeType 



FoundByte; 
ByteAddress; 
CurrentBlockAddress 
OldReadBuf f erNext 



= BlockAddress (Address) ; 
= ReadBuf fer .Next; 



ReadMemoryRequest .Address 
ReadMemoryRequest . Size 
ReadMemoryRequest .RequiredSize 
ReadMemoryRequest .Block 
ReadMemoryRequest .Priority 
ReadMemoryRequest .Access InProgress 
ReadMemoryRequest .TimeToExecute 
ReadMemoryRequest . CompletionTimeEstimate 



Address; 

Size; 

RequiredSize; 

Block; 

Priority; 

No; 

0 ; 

0 ; 
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★ * 



AddToReadBuf fer 
continued 






(CacheWaitingFor==CacheWaitingForFullReadBuffer) CacheWaitmgFor=Nothmg; 
undByte=Yes; 

ile (FoundByte==Yes && Size>0) 

{ 

FoundByt e=No; 

if (SearchCache (Address) ==Yes) 

FoundByte=Yes; 

else if (SearchBlockBuf fer==Yes && Search (&BlockBuf fer, Address)) 

FoundByt e=Yes; 
if (FoundByt e==Yes ) 

{ 

Address++; 

if (BlockAddress (Address) i =CurrentBlockAddress) Address-=BlockSize; 
if (Size>0) Size — ; 

if (RequiredSize>0) RequiredSize — / 

} 

} 

iteAddress=Address+Size-l; 

(BlockAddress (ByteAddress) ! =CurrentBlockAddress) ByteAddress-=BlockSize; 
'undByte=Yes; 

lile (FoundByte==Yes && Size>0) 

{ 

FoundByt e=No; 

if (SearchCache (ByteAddress) ==Yes) 

FoundByt e=Yes; 

else if (SearchBlockBuf fer==Yes && Search (&BlockBuffer, ByteAddress)) 
FoundByte=Yes; 
if (FoundByt e==Yes) 

ByteAddress — ; 

if (BlockAddress (ByteAddress) ! =CurrentBlockAddress) 
ByteAddress+=BlockSize; 
if (Size>0) Size — ; 

if (RequiredSize>Size) RequiredSize=Size; 

} 

} 

(Request==Read && Test==No) 

{ 

if (RequiredSize==0 && CacheHit==No) 

Buf ferHit=Yes; 
else 

Buf ferHit=No; 

} 

L (RequiredSize==0 && Request==Read) CacheWaitmgFor=Nothing; 

R idMemoryRequest .Address = Address; 

R adMemoryRequest . Size = Size; 

R adMemoryRequest .RequiredSize = RequiredSize; 

i (RemoveReadDuplicates==No && Size>0) 

Append (&ReadBuffer, &ReadMemoryRequest ) ; 
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AddToReadBuf fer 
continued 



ile (Size>0 && RemoveReadDuplicates==Yes) 

< 

FoundByte=No; 

if (SearchCache (Address) ==Yes) 

FoundBy te=Yes ; 

else if (SearchBlockBuf fer==Yes && Search (SBlockBuf fer, Address)) 
FoundBy t e=Yes ; 

if (FoundBy te==No) 

Splice (&ReadBuf fer, Address, RequiredSize, Block, Priority) ; 
Address++; 

if (BlockAddress (Address) ! =CurrentBlockAddress) Address-=BlockSize; 
if (Size>0) Size — ; 

if (RequiredSize>0) RequiredSize — ; 



(Request==Read && Test==Yes) 

{ 

if (ReadBuf fer .Next==01dReadBuf f erNext && CacheHit==No) 
Buf ferHit^Yes; 
else 

Buf fer Hit =No ; 

} 



:iculateTimeEstimates () ; 
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** Cache. c ** 

* ★ ★ ★ 

** SearchCache ** 



** Description: ** 

* ★ ★ ★ 



★ ★ 
★ ★ 
★ * 
★ ★ 
* ★ 
★ ★ 
★ ★ 
★ ★ 

★ it 

★ ★ 



SearchCache is called by AddToReadBuf fer to find any parts of 
the request that may be already located in the cache. This must be 
done because if a read request follows a write request using a write 
allocate policy then part of the read may be in the cache while the 
rest may still need to be read from memory. Search Cache checks all 
CacheBlockAddresses in the cache set. If any of the cache block 
addresses equals the block address of the byte, then Search Cache 
checks the CacheValidBit for the sub block that the byte is located in. 
If the sub block is valid then SearchCache returns Yes. 



★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



★ ★ 
★ ★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★a-* j 



YesNoType SearchCache (Address) 

AddressType Address; 

( 

SizeType FirstBlock = Set (Address) *Associativity; 
SizeType LastBlock = FirstBlock+Associativity-1 ; 
SizeType Blocklndex; 

YesNoType FoundByte; 



for (BlockIndex=FirstBlock; BlockIndex<=LastBlock; BlockIndex++) 
if (CacheBlockAddress [Blocklndex ] ==BlockAddress (Address) ) 

if (CacheValidBit [Blocklndex] [SubBlock (Address) ] ) FoundByte=Yes; 

return (FoundByte) ; 



} 
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AddToWriteBuf fer 



)escnption : 

AddToWriteBuf fer adds one record to write buffer. It also updates 
he ReadBuffer it the UpdateReadBuf fer arguments is asserted. The 
>rocess of updating the ReadBuffer is simply changein the requests so 
hat data make available by the write request is not requested form 
lemory. UpdateReadBuf fer should not be used unless the word and sub 
dock sizes are equal. This is because a write request may reduce a 
ead request to where the read request will not be large enough to 
alidate a sub block. The write request may alsobe unable to set any 
alid bits because of sub block alignment. The result is that a sub 
dock was supposed to be read in is not. 



AddToWriteBuf fer (Address, Size, Priority) 

dressType Address; 
zeType Size; 

iorityType Priority; 



moryRequestType WriteMemoryRequest ; 



sNoType 

dressType 

dressType 

zeType 

ff erSizeType 



FoundByte; 
ByteAddress; 
CurrentBlockAddress = 
NoBytes; 

OldWriteBuf f erNext = 



BlockAddress (Address) ; 
WriteBuf fer .Next ; 



f iteMemoryRequest .Address 
* iteMemoryRequest . Size 
iteMemoryRequest .RequiredSize 
iteMemoryRequest .Block 
iteMemoryRequest .Priority 
iteMemoryRequest . AccessInProgress 
iteMemoryRequest . TimeToExecute 
f iteMemoryRequest . CompletionTimeEst imate 



= Address; 

= Size; 

= 0 ; 

= 0 ; 

= Priority; 
= No; 

= 0 ; 

= 0 ; 
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★ ★ 
★ ★ 
* ★ 



AddToWriteBuf f er 
continued 



★ * 
★ ★ 
★ ★ 






if (CacheWaitingFor==CacheWaitingForFullWriteBuf fer) 
CacheWaitingFor=Nothing; 

FoundByte=Yes; 

while (FoundByte==Yes && UpdateReadBuf f er==Yes) 

< 

FoundByte=No; 

Byt eAddress=Address ; 

for (NoBytes=0/ NoBytes<Size; NoBytes++) 

i 

if (UpdatingReadBuf fer (ByteAddress) ==Yes) FoundByte=Yes; 
ByteAddress++; 

if (BlockAddress (ByteAddress) ! =CurrentBlockAddress) 
ByteAddress-=BlockSize; 

} 

} 

if (RemoveWriteDuplicates==No && Size>0) 

Append (&WriteBuf fer, &WriteMemoryRequest ) ; 

while (RemoveWriteDuplicates==Yes && Size>0) 

i 

Splice (&WriteBuf fer, Address, 0, 0, Priority) ; 

Address++; 

if (BlockAddress (Address) ! =CurrentBlockAddress) Address-=BlockSize; 
if (Size>0) Size — ; 

> 

if (Request==Write) 

i 

Buf ferHit=No; 

if (WriteBuf fer ,Next==01dWriteBuf ferNext && CacheHit==No) Buf ferHit=Yes; 
if (WriteBuf fer .Next==01dWriteBuf ferNext && 

CacheWaitingFor ! =CacheWaitingForFullWnteBuf fer) 
CacheWaitingFor=Nothing; 

> 

CalculateTimeEstimates () / 



} 



**★★*★★***★★*****************•*-******** 
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Program Modified: 3/17/94 
File Modified: 3/17/94 



Page 5-0 ** 

★ ★ 

★ * 
★ * 
★ * 
★ ★ 



Author: William G. Smith 

Address: Electrical Engineering Department 

Naval Postgraduate School 
Monterey, CA 93940 



Copyright 1994, William G. Smith ** 

★ ★ 

Permission to use, copy, modify, and distribute this software and ** 

its documentation for any purpose and without fee is hereby granted ** 

provided that the above copyright notice appears in all copies. No ** 

modified version of this program should be redistributed without the ** 
authors consent. William G. Smith makes no warranty or ** 

representation, promise of guarantee, either expressed or implied, ** 

with respect to this software's ability to produce valid results. ** 

This program is provided "as is" any financial, personal or property ** 

damage caused by the use of this program is the responsibility of the ** 
user. ** 



★*★****+*★★★★★★**★**★★★★★**+★**★**★***★★*★****★★★★★★**★★**★*★★★★*★***★★*/ 






★ ★ 
★ ★ 
★ ★ 
* ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
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Memory . c 



Description: 



★ ★ 

★ ★ 

★ ★ 

★ * 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ * 

★ ★ 

★ ★ ★ ★ ★ i 



Memory. c contains all functions that relate to the simulation of 
main memory. Memory Model makes all the necessary calls to simulate 
main memory. MemoryModel decides which calls to make, based on 
MemoryWaitingFor . This function is called every time Time is 
incremented. If there are no read or write requests waiting to be 
completed, the function does nothing. Memory Model contains a loop 
that forces the procedure to continue modeling until TOA and TOD are 
not equal to Time. This insures that if there are any events that 
occur in zero clock cycles then the next event is allowed to start. 

Memory Model calls SelectMemoryRequest to choose a request from 
either the read or the write buffers. Memory Model calls Start Reads, 
and Start Writes, to simulate accessing memory and receiving the first 
word of a memory request. ContinueMemoryReads, and 

ContinueMemoryWrites are then called to simulate the memory transfer 
of the following words of data. 

The simulation of main memory includes: 

Choosing memory request from read, write buffers. 

Simulated memory access times. 

Simulated memory transfer times. 

Cache Update after memory read. 

Table of Contents 
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List of Memory. c Function Declarations .. 
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♦include "Global. h 
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Page 5- 2 ** 




Description: ** 

★ ★ 

This is a list of function declarations within the file scope ** 

of Memory. c ** 

★ ★ 



MemoryModel () ; 


/* 


Page 


5- 3 


*/ 


SelectMemoryRequest () ; 


/* 
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*/ 


StartMemoryReads () ; 


/* 
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*/ 


Con tinueMemory Reads () ; 


/* 
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*/ 


StartMemoryWrites () ; 


/* 
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ContinueMemory Writes () ; 


/* 
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*/ 


UpdateCache () ; 


/* 
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*/ 


AddAWordToMemory Request () ; 


/* 
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*/ 


RemoveAWordFromMemoryRequest () ; 


/* 
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*/ 



★ * 









t *• ★ ★ ★ ★ i 
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★ ★ 
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★ ★ 
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Description : 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



★ ★ 
★ ★ 



Memory. c contains all functions that relate to the simulation of 
main memory. Memory Model makes all the necessary calls to simulate 
main memory. MemoryModel decides which calls to make, based on 
MemoryWaitingFor . This function is called every time Time is 
incremented. If there are no read or write requests waiting to be 
completed, the function does nothing. Memory Model contains a loop 
that forces the procedure to continue modeling until TOA and TOD are 
not equal to Time. This insures that if there are any events that 
occur in zero clock cycles then the next event is allowed to start. 

Memory Model calls SelectMemoryRequest to choose a request from 
either the read or the write buffers. Memory Model calls Start Reads, 
and Start Writes, to simulate accessing memory and receiving the first 
word of a memory request. ContinueMemoryReads, and 

ContinueMemoryWntes are then called to simulate the memory transfer 
of the following words of data. 

The simulation of main memory includes: 

Choosing memory request from read, write buffers. 

Simulated memory access times. 

Simulated memory transfer times. 

Cache Update after memory read. 



★ ★ 
★ ★ 



★ ★ 
★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 









void MemoryModel () 



Memory Wait ingForType Las tMemory Wait mgFor; 
do 



Las tMemoryWait ingFor=Memory Wait ingFor; 

if (MemoryWaitingFor==Nothing) SelectMemoryRequest (&MemoryWait ingFor) ; 

else if (MemoryWaitingFor==MemoryWaitingForMemoryReadRequest I I 
Memory Wait ingFor —Memory Wait ingForCacheUpdate) 
StartMemoryReads () ; 

else if (MemoryWaitingFor==MemoryWait ingForMemoryReadAccess I I 
Memory Wait ingFor==MemoryWaitmgForMemoryReadTransfer) 
ContinueMemoryReads () ; 

else if (MemoryWaitingFor==MemoryWaitingForMemoryWriteRequest) 
StartMemoryWrites () ; 

else if (MemoryWaitingFor==MemoryWaitingForMemoryWriteAccess I I 
MemoryWaitingFor==MemoryWaitingForMemoryWriteTransfer) 

Cont inueMemoryWrites () ; 

} 

while (MemoryWaitingFor 1 =Las tMemoryWait ingFor || TOA— Time II TOD==Time) ; 



} 
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SelectMemoryRequest 

Description : 

SelectMemoryRequest is called when memory is waiting for nothing 
SelectMemoryRequest chooses a request from either the read or write 
buffers, based on priority. The request is not returned however, the 
request is left at the top of the buffer with its Priority and 
Accesslnprogress set equal to Yes. If a request is found then 
MemoryWaitingFor is set to MemoryReadRequest, or MemoryWriteRequest 
depending on whether the request was found in the read or write 
buffers . 



SelectMemoryRequest (MemoryWaitingFor) 
emoryWaitingForType *MemoryWaitingFor; 



emoryRequestType ReadMemoryRequest ; 
emoryRequestType WriteMemoryRequest ; 

f ( ! (ReadBuf fer .Empty) ) 

ReadMemoryRequest=View (&ReadBuf f er) / 

Ise 

ReadMemoryRequest . Priority=NoPriority; 

f (! (WriteBuf fer .Empty) ) 

WriteMemoryRequest=View (&WriteBuf fer) ; 
lse 

WriteMemoryRequest . Priority=NoPriority ; 

f (ReadMemoryRequest . Prior ity<=WriteMemoryRequest .Priority && 
ReadMemoryRequest .Priority l =NoPrionty) 

{ 

*MemoryWaitingFor=MemoryWaitingForMemoryReadRequest ; 
ReadMemoryRequest . Access I nProgress=Yes; 

ReadMemoryRequest .Priority=0; 

ChangeTopMemoryRequest UReadBuf f er, & ReadMemoryRequest ) ; 

} 

lse if (WriteMemoryRequest .Priority ! =NoPriority) 

{ 

*MemoryWaitingFor=MemoryWaitingForMemoryWriteRequest ; 
WriteMemoryRequest . AccessInProgress=Yes; 

WriteMemoryRequest .Priority=0; 

ChangeTopMemoryRequest (SWriteBuf f er, & WriteMemoryRequest) ; 

} 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A.****.**.*. 
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** Memory, c * + 

** ** 

** StartMemoryReads ** 

★ ★ ★ ★ 

** Description: ** 



** StartMemoryReads begins a read request, simulating the first word 

** read from memory. The time to complete this read is called 
** MemoryAccessTime. The BlockBuffer is initialized in preparation to 
** receive the new data words. If BlockWaitingFor is not equal to 
** Nothing the StartMemoryReads will have to wait until it is before 
** allowing the new memory read request to start. If StartMemoryReads 
** does have to wait for the cache then Memory Wait ingFor it set equal to 
** CacheUpdate, otherwise MemoryWait ingFor is set to MemoryReadAccess . 

** The new block record is equal to the ReadBuffer with its sizes set to 
** zero. This gives the Block Memory Request the same block number and 
** the ReadMemoryRequest . The Address is aligned to WordSize. The 
** Address must be aligned because the words read in will be aligned 
** to WordSize. The new BlockMemoryRequest is simply pushed onto the 
** Block Buffer. The BlockWaitingFor is set equal to MemoryBlockTransfer . 
** To indicate that data is being transferred from memory to the 
** BlockBuffer. 




★ ★ 
★ ★ 



★ ★ 
★ ★ 
★ ★ 



★ ★ 
* ★ 
★ ★ 
★ ★ 






void StartMemoryReads () 



Memory Request Type ReadMemoryRequest ; 

MemoryRequestType BlockMemoryRequest; 

if (BlockWaitingFor==Nothing) 

{ 

ReadMemoryRequest=View (&ReadBuf fer) ; 

T 0 A= T ime +Memo ryAccessTime; 

MemoryWait ingFor=Memory Wait ingForMemoryReadAccess; 
BlockMemoryRequest =ReadMemoryRequest ; 

BlockMemoryRequest . Address=WordAddress (ReadMemoryRequest .Address) ; 
BlockMemoryRequest . Size=0; 

BlockMemoryRequest .RequiredSize=0; 

BlockMemoryRequest .Priority=0; 

BlockMemoryRequest . Access InProgress=No; 

Push (&BlockBuf fer, &BlockMemoryRequest ) ; 

BlockWaitmgFor=MemoryBlockTransfer; 

} 

else 

{ 

MemoryWait ingFor=Memory Wait ingForCacheUpdate ; 

} 



} 
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★ ★ 



★ ★ 

ContinueMemoryReads ** 

★ ★ 

Description: ★★ 

★ ★ 

ContinueMemoryReads continues the memory read request started by 
StartMemoryReads . It simulates every read from memory other than the ** 
first word which was simulated by StartMemoryReads. The time to ** 

complete each word transfer is equal to MemroyTransferTime . The block, ** 
and read buffers are altered every time a word is read from memory. ** 

Dnce a request is complete, it is removed from the Read Buffer, and ** 

Memory WaitingFor is reset to Nothing. Block Waiting For is set to ** 

BlockCacheAccess in preparation to transfer the new data to the cache. ** 
If the CompletionTimeEstimate for the memory read request is not equal ** 
to Time then a time predition error is rased. ** 

★ ★ 






ContinueMemoryReads () 



emoryRequestType BlockMemoryRequest ; 
emoryRequest Type ReadMemoryRequest ; 

f (TOA<=Time) 



BlockMemoryRequest=View (&BlockBuf f er) ; 

AddAWordToMemoryRequest (^BlockMemoryRequest ) ; 

ChangeTopMemoryRequest (&BlockBuf f er, &BlockMemoryRequest ) ; 

ReadMemoryRequest=View (&ReadBuf fer) ; 

RemoveAWordFromMemoryRequest (&ReadMemoryRequest ) ; 

if (ReadMemoryRequest . Size>0) 

{ 

ChangeTopMemoryRequest UReadBuf fer, &ReadMemoryRequest ) ; 
TOA=Time+MemoryTrans f erTime ; 

MemoryWai tingFor=Memory Wait ingForMemoryReadTrans fer; 

} 

else 

{ 

Pop UReadBuf fer) ; 

TOA=0; 

if (Time i =ReadMemoryRequest .CompletionTimeEstimate) 

PrintTimePredictionError (ReadMemoryRequest . CompletionTimeEstimate, 

Time, 

"Read”, 

"ContinueMemoryReads") ; 

MemoryWaitingFor=Nothing; 

BlockWaitingFor=BlockCacheAccess; 

BlockTOA=Time+Buf fer CacheAccess Time; 

} 



TotalNumberOfWordsReadFromMemory++; 
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★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 



ContinueMemoryReads 

continued. 



★ * 
★ ★ 
★ ★ 
★ * 
★ * 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-* . 



else 



{ 

ReadMemoryRequest=View (SReadBuf f er) ; 



if (ReadMemoryRequest . Size“0) 

Pop (&ReadBuf fer) ; 

TOA=0; 

if (Time l ^ReadMemoryRequest . CompletionTimeEstimate) 

PrintTimePredictionError (ReadMemoryRequest . CompletionTimeEstimate, 

Time, 

"Read", 

"ContinueMemoryReads") ; 

Memory Wait ingFor=Nothing; 

BlockWaitingFor=BlockCacheAccess; 

BlockTOA==Time+Buf ferCacheAccessTime; 

} 



> 
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StartMemoryWrites 



Description : 

StartMemoryWrites begins a memory write request, simulating the 
first word written to memory. The time to complete this one word write 
is called MemoryAccessTime . MemoryWaitingFor is set to 
MemoryWriteAccess . 






StartMemoryWrites () 



f (MemoryWaitingFor==MemoryWaitingForMemoryWriteRequest) 

< 

TOD=Time+MemoryAccessTime ; 

Memo ryWaitingFor=MemoryWaitmgFo rMemo ryWnteAccess; 

} 
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** Memory. c ** 

★ ★ ★ ★ 

** ContinueMemoryWrites ** 

★ ★ ★ ★ 

** Description: ** 

★ * ★ 

** ContinueMemoryWrites continues the memory write request started ** 

** by StartMemoryWrites . Like ContinueMemoryReads, it simulates every ** 

** write to mwmory other than the first word which was simulated by ** 

** StartMemroyWrites . The time to complete each word transfer is equal ** 

** to MemoryTransferTime . The Write Buffer is altered every time a word ** 

** is written to memory. Once the memory write request is complete, it ** 

** is removed form the WriteBuffer, and Memory Wait ingFor is reset to ** 

** Nothing. If the CompletionTimeEstimate for the memory read request is ** 

** not equal to Time when the request is completed then a time predition ** 

** error is rased. ** 

★ ★ ★ ★ 



void ContinueMemoryWrites () 

< 

MemoryRequestType WriteMemoryRecjues t ; 

if (TOD<=Time) 

{ 

WriteMemoryRequest=View UWriteBuf fer) ; 

RemoveAWordFromMemoryRequest (&WriteMemoryRequest ) ; 
if (WriteMemoryRequest . Size>0) 

{ 

ChangeTopMemoryRequest ( &WriteBuf f er, &WriteMemoryRequest) ; 
TOD=Time+MemoryTransf erTime; 

MemoryWaitingFor=MemoryWaitingForMemoryWriteTransfer; 

} 

else 

{ 

Pop (&WriteBuf f er) ; 

TOD«0; 

if (Time ! =WriteMemoryRequest . CompletionTimeEstimate) 

PrintTimePredictionError (WriteMemoryRequest . CompletionTimeEstimate, 

Time, 

"Write", 

"ContinueMemoryWrites") ; 

Memo ry Wait ingFor=Nothing; 

} 

To talNumberOf Words Writ tenToMemory++; 

} 
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★ ★ 



★ ★ 



ContinueMemoryWrites ** 

continued ** 

★ ★ 



Ise 

{ 

WriteMemoryRequest=View (&WriteBuf f er ) ; 
if (WriteMemoryRequest . Size==0) 

{ 

Pop (&WriteBuffer) ; 

TOD=0; 

if (Time 1 =WriteMemoryRequest . CompletionTimeEstimate) 

PrintTimePredictionError (WriteMemoryRequest .CompletionTimeEstimate, 

Time, 

"Write", 

"ContinueMemoryWrites") ; 

MemoryWaitingFor=Nothing; 

} 



★ ★ 
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★ ★ 

** UpdateCache 

★ ★ 

** Description: 

★ ★ 

** UpdateCache simulates entering data from the BlockBuffer into the 

** cache. UpdateCache first checks wheter of not the cache is busy. If 
** it is not then CacheBusy is asserted, and BlockWaitingFor is set equal 
** to BlockCacheTransfer . The BlockTOA is calculated, to enable 
** CalculateTimeEstimates to predict the completion times for additional 
** memory read request in the buffer. If the cache is busy then the 
** previous memory request time completions may be wrong. That is because 
** the last estimates conunted on the old BlockTOA. This means that all 
** the time estimates must be recalculated. 

★ ★ 

** Once the Buf f erCacheAccessTime has expired then BlockWaitingFor 

** is set equal to Nothing, and the CacheBusy is deserted. The read data 
** must then be removed from the BlockBuffer. The appropriate sub blocks 
** in the cache will then have there dirty bits cleared, and valid bits 

** set. 

★ ★ 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★it** 



void UpdateCache () 

{ 

MemoryRequestType BlockMemoryRequest ; 
Addr e s s Type TempAddr e s s ; 
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★ ★ 



UpdateCache ** 

continued ** 

★ ★ 



f (BlockWaitingFor==BlockCacheAccess && CacheBusy==Yes) 

{ 

BlockTOA=Time+Buf f erCacheAccessTime+1; 

CalculateTimeEstimates () ; 

} 

f (BlockWaitingFor==BlockCacheAccess CacheBusy==No) 

{ 

CacheBusy=Yes; 

BlockTOA=Time+Buf ferCacheAccessTime; 

BlockWaitingFor^BlockCacheTransfer; 

> 

f (BlockWaitingFor==BlockCacheTransfer && BlockTOA<=Time) 

{ 

CacheBusy=No; 

BlockWaitingFor=Nothing; 

BlockTOA=0 ; 

BlockMemoryRequest=Pop (&BlockBuf fer) / 
if (CacheBlockAddress [BlockMemoryRequest .Block] == 

BlockAddress (BlockMemoryRequest .Address) ) 

{ 

for (TempAddress=BlockMemoryRequest .Address; 

T emp Addr ess<=Bloc kMemo r y Re quest. Addr ess 
+BlockMemoryRequest . Size-1 ; 
TempAddress+=SubBlockSize) 

{ 

CacheDirtyBit [BlockMemoryRequest .Block] [SubBlock (TempAddress) ] =No; 
CacheValidBit [BlockMemoryRequest .Block] [SubBlock (TempAddress) ]=Yes 
> 

} 

> 

lse 

{ 

BlockMemoryRequest=View (&BlockBuf fer ) ; 

BlockMemoryRequest . TimeToExecute=Buf ferCacheAccessTime; 
BlockMemoryRequest . CompletionTimeEstimate=BlockTOA; 
ChangeTopMemoryRequest (&BlockBuf f er, &BlockMemoryRequest) ; 

} 



/★★★★★★★★★★★★★*★★★★★★**★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★***★★*★★★★★★★★★ 
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★ ★ 

AddAWo r dToMemo r y Reque s t ** 

★ ★ 



★ ★ 
★ ★ 
★ ★ 
* ★ 



** Description: 

★ ★ 

** AddAWordToMemoryRequest adds a word to a MemoryRequest as if it 

** had been read in from memory. The address is first aligned to 

** WordSize. This simulates the data being added to the request. 

★ ★ 



★ ★ 
★ ★ 



★ * 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A- j 



void AddAWordToMemoryRequest (MemoryRequest ) 

MemoryRequestType ^MemoryRequest ; 

{ 

MemoryRequest->Address=WordAddress (MemoryRequest->Address) ; 
MemoryRequest->Size+=WordSize; 

} 
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RemoveAWordFromMemoryRequest 



Description : 

RemoveAWordFromMemoryRequest removes a word from a Memory Request, 
as if it had been written to memory. A copy of the Address is first 
stored in OldAddress. Then the Address is word aligned and incremented 
by WordSize. The Required Size, and Size are then decremented by the 
difference of the new Address, and the OldAddress. Finally if the 
Address is outside the range of the original block then the Address is 
decremented by BlockSize to simulate modulo addition. This simulates 
removing a word from the memory request taking into account word and 
block alignment constraints . 



i RemoveAWordFromMemoryRequest (MemoryRequest ) 
Memory Request Type ^MemoryRequest ; 

{ 



address Type OldAddres s=MemoryRequest-> Address; 

4emoryRequest->Address=WordAddress (MemoryRequest->Address) +WordSize; 

if (MemoryRequest->Size>BlockSize-WordSize) 

MemoryReques t-> Si ze=B locks ize-WordSize; 
alse if (MemoryRequest->Size>MemoryRequest->Address-01dAddress) 
MemoryRequest->Size-=MemoryRequest->Address-01dAddress; 

2 lse 

MemoryRequest->Size=0; 

if (MemoryRequest->RequiredSize>BlockSize-WordSize) 
MemoryRequest->RequiredSize=BlockSize-WordSize; 

2lse if (MemoryRequest->RequiredSize>MemoryRequest->Address-01dAddress ) 
MemoryRequest->RequiredSize-=MemoryRequest->Address-01dAddress; 

slse 

MemoryRequest->RequiredSize=0; 

if (BlockAddress (OldAddress) <BlockAddress (MemoryRequest->Address) ) 
MemoryRequest->Address-=BlockSize; 
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★ * 
★ ★ 
★ * 
•k k 
★ * 
★ ★ 
★ ★ 



Author: William G. Smith 

Address: Electrical Engineering Department 

Naval Postgraduate School 
Monterey, CA 93940 

Copyright 1994, William G. Smith 

Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 

This program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
user. 
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escription : 

TimeEst. c contains all functions that relate to estimating the 
xecution, and completion times of memory requests. 

Table of Contents 



Cover Page Page 6- 1 

List of TimeEst. c Function Declarations ... Page 6- 2 

UpdateTimeToExecute ( ) Page 6- 3 

CalculateTimeEstimates () Page 6- 5 






ude " Global. h" 
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TimeEst . c ** 

★ ★ 

List of TimeEst. c Function Declarations 



★ ★ 
★ ★ 
★ ★ 



Description: 



★ ★ 
★ ★ 
★ ★ 



** This is a list of function declarations within the file scope ** 

** of TimeEst. c ** 
★ ★ ★ ★ 
★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-A-* j 



void UpdateTimeToExecute () ; 
void CalculateTimeEstimates ( ) ; 



/* Page 6- 3 */ 
/* Page 6- 5 */ 
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UpdateTimeToExecute 



Description : 

UpdateTimeToExecute calculates the time to complete a memory 
transfer given the MemoryRequest . The Memory Request could be a read 
or write request in a buffer. UpdateTimeToExecute changes the 
TimeToExecute field to the new value. TimeToexecute is calculated by 
first finding the number of WordsToBeTransfered. If the MemoryRequest 
is not being accessed then the TimeToExecute is simply the AccessTime 
plus the TransferTime times one less then WordsToBeWritten . If the 
MemoryRequest is in progress then the new TimeToExecute is dependent 
on TOA, or TOD of the next word. MemoryWaitingFor dictates whether to 
use the TOA, or TOD. If MemoryWaitingFor is equal to CacheUpdate then 
the request has not actually begun transferring data. So the 
TimeToExecute can be calculated as if the read request is not in 
progress . 



.1 UpdateTimeToExecute (MemoryRequest) 
lemoryRequestType *MemoryRequest; 



JizeType WordsToBeTransfered; 



.f (MemoryRequest->Size>0) 

{ 

WordsToBeTransf ered=WordAddress (MemoryRequest->Address 

+MemoryRequest->Size-l ) 

-WordAddress (MemoryRequest->Address) +WordSize; 

) 

:lse 



{ 

WordsToBeTransf ered=0; 

} 



JordsToBeTransfered/=WordSize; 

.f (WordsToBeTransfered> (Blocks ize/WordSize) ) 
Words ToBeTransfered=BlockSize/WordSize; 






★ ★ 
★ ★ 
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** UpdateTimeToExecute ** 
** continued . ** 
★ ★ ★ ★ 
★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-a- ^ 



if (WordsToBeTransfered>0) 

{ 

if (MemoryRequest->AccessInProgress==No) 

{ 

MemoryRequest->TimeToExecute=MemoryAccessTime 

+MemoryTransferTime* (WordsToBeTransfered-1) ; 

} 

else 

{ 

if (MemoryWaitingFor==MemoryWaitingForMemoryReacLAccess | | 
Memory Wait ingFor==Memory Wait mgForMemoryReadTransfer) 

{ 

MemoryRequest->TimeToExecute=TOA-Time+MemoryTransferTime 

* (WordsToBeTransfered-1) ; 



else if (MemoryWaitingFor==MemoryWaitingForMemoryWriteAccess I I 
Memory Wai t ingFor==MemoryWait ingForMemory Writ eTransfer ) 

{ 

MemoryRequest->TimeToExecute=TOD-Time+MemoryTransferTime 

* (WordsToBeTransfered-1) ; 

} 

else if (Memory Wait ingFor==MemoryWaitingForCacheUpdate) 

{ 

MemoryRequest->TimeToExecute=MemoryAccessTime+MemoryTransferTime 

* (WordsToBeTransfered-1) ; 

} 

else 

{ 

printf ("Error found in [UpdateTimeToExecute] MemoryRequest\n" ) ; 
printf("with access in progress while MemoryWaitingFor not\n"); 
printf ("reading or writing."); 

DiscrepancyFound=Yes; 

} 



} 



else 

{ 

MemoryRequest->TimeToExecut e=0 ; 

} 



> 
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CalculateTimeEstimates 



Description: 

CalculateTimeEstimates updates the CompletionTimeEstimates for 
sach request in both the read and write buffers. This funtion is 
called when ever the CacheModel adds to the read or write buffers. 
DalculateTimeEstimates must be called every time new data is entered 
into the buffers. This is because all previous estimates did not take 
into account the new data requested. This is because all previous 
2 Stimates did not take into account the new data requested. 
DalculateTimeEstimates first orders all entries in both the ReadBuffer, 
and the WriteBuffer by priority. Then CalculateTimeEstimates steps 
:hough both buffers simultaneously. Each time picking the request that 
aas the highest priority, and adding the time to execute to the 
rimeEstimate . The TimeEstimate becomes that requests 
DompletionTimeEstimate . This process is repeated until all requests 
iave a new CompletionTimeEstimate . TimeToExecute for cache request is 
apdated before it is used to calculate the TimeEstimate. 



CalculateTimeEstimates () 



af f erSizeType ReadIndex=0; 
af ferSizeType WriteIndex=0; 

LmeType TimeEst imate=Time; 

LmeType BlockTOAEstimate=BlockTOA; 

rder UReadBuf fer) ; 
rder UWriteBuf fer) ; 
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CalculateTimeEstimates 

continued 



Page 6-6 ** 



★ ★ 
★ ★ 



★ ★ 

★ ★ 

★ ★ 

★ ★ 

** continued ** 

★ ★ ★ ★ 



while (ReadIndex<ReadBuf fer .Next I I WriteIndex<WnteBuf fer .Next ) 



if (ReadIndex<ReadBuf fer .Next && WriteIndex<WriteBuf fer .Next ) 

{ 

if (ReadBuf fer .Memory Re quest [ Readlndex ] .Priority <= 

WriteBuf fer .MemoryRequest [Writelndex] .Priority) 

{ 

UpdateTimeToExecute (& (ReadBuf fer .MemoryRequest [Readlndex] ) ) ; 

if (TimeEst imate<BlockTOAEstimate) TimeEstimate=BlockTOAEstimate; 
TimeEstimate+=ReadBuf fer .MemoryRequest [Readlndex] . TimeToExecute; 
ReadBuf fer .MemoryRequest [Readlndex] . CompletionTimeEstimate= 
TimeEst imate; 

BlockTOAEstimate=TimeEstimate+Buf ferCacheAccessTime; 

Readlndex++; 

} 

else 

{ 

UpdateTimeToExecute (& (WriteBuf fer .MemoryRequest [Writelndex] ) ) ; 

TimeEst imate+=Wr it eBuf fer .MemoryRequest [Writelndex] .TimeToExecute; 
WriteBuf fer .MemoryRequest [Writelndex] . CompletionTimeEstimate= 
TimeEstimate; 

Writelndex++; 

} 

} 

else if (ReadIndex<ReadBuf fer .Next ) 

{ 

UpdateTimeToExecute (& (ReadBuf fer .MemoryRequest [Readlndex] ) ) ; 

if (TimeEstimate<BlockTOAEstimate) TimeEstimate=BlockTOAEstimate ; 
TimeEst imate+=ReadBuf fer .MemoryRequest [Readlndex] . TimeToExecute; 
ReadBuf fer .MemoryRequest [Readlndex] . CompletionTimeEstimate= 
TimeEstimate; 

BlockTOAEstimate=TimeEstimate+Buf ferCacheAccessTime; 

Readlndex++; 

} 

else if (WriteIndex<WriteBuf fer .Next ) 

{ 

UpdateTimeToExecute (& (WriteBuf fer .MemoryRequest [Writelndex] ) ) ; 

TimeEstimate+=WriteBuf f er .MemoryRequest [Writelndex] . TimeToExecute; 
WriteBuf fer .MemoryRequest [Writelndex] . CompletionTimeEstimate= 
TimeEstimate; 

Writelndex++; 

} 



} 



} 



★ ★★★★★★♦★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-* 
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★ ★ 

Part Of SACS 1.0 ** 

(StillAnother Cache Simulator) ** 

★ ★ 

Program Modified: 3/17/94 ** 

File Modified: 3/17/94 ** 

★ ★ 

Author: William G. Smith ** 

Address: Electrical Engineering Department ** 

Naval Postgraduate School ** 

Monterey, CA 93940 ** 

★ 

Copyright 1994, William G. Smith ** 

*★ 

Permission to use, copy, modify, and distribute this software and ** 

its documentation for any purpose and without fee is hereby granted ** 

provided that the above copyright notice appears in all copies. No ** 

modified version of this program should be redistributed without the ** 
authors consent. William G. Smith makes no warranty or ** 

representation, promise of guarantee, either expressed or implied, ** 

with respect to this software's ability to produce valid results. ** 

This program is provided "as is" any financial, personal or property ** 

damage caused by the use of this program is the responsibility of the ** 

user. ** 
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Description: 



Get.c contains ail functions that relate getting the next CPU 
request. GetNextRequest is the only procedure called outside of this 
file scope. It determines whether to take input from the keyboard or 
an input file. It also checks the input data to see if it makes sense. 

Table of Contents 
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★ ★ j 



# include "Global. h" 



************************************************************************** 



Get . c 

List of Get.c Function Declarations 
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★ ★ 



★ ★ 
★ ★ 



)escription: ** 

★ + 

This is a list of function declarations within the file scope ** 

)f "Get.c". ** 

* ★ 



GetNextRequest () ; 

GetNextFileRequest () ; 
GetNextKeyBoardRequest () ; 



/* Page 7- 3 */ 
/* Page 7- 5 */ 
/* Page 7- 6 */ 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★a-******* 

** Page 7-3 ** 

* * Get . c * * 

★ ★ ★ ★ 

** GetNextRequest ** 

* ★ * * 

** Description: ** 

* * ★ ★ 

** GetNextRequest gets the next simulated request from the CPU to ** 

** cache (ie a Read or Write request) . The request is checked to make ** 

** sure it makes sense. If a request is not block alined, then ** 

** GetNextRequest will split the request up and return portions of the ** 

** request until all portions have been used, as if the user had made ** 

** several different requests. ** 

★ ★ ★ ★ 



void GetNextRequest () 

{ 

static AddressType NextRequestAddress; 
static SizeType NextRequestSize=0; 
static RequestType NextRequest; 
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★ ★ 
★ ★ 
★ ★ 
* ★ 



GetNextRequest 

continued 



★ ★ 



if (NextRequestSize<=BlockSize) 

{ 

Request Si ze=Next Request Size; 

NextRequestSize=0; 

} 

else 

{ 

Request Si ze=BlockSize ; 

NextRequestSize-=BlockSize; 

} 

RequestAddress=BlockAddress (RequestAddress) +BlockSize; 
Request^NextRequest ; 

} 



if (KeyBoardIO) 

{ 

PauseForCommand ( ) ; 

GetNextKeyBoardRequest () ; 

} 

else 

{ 

GetNextFileRequest () ; 

} 

if (BlockAddress (RequestAddress) 1= 

BlockAddress (RequestAddress+RequestSize-1) ) 

{ 

NextRequestSize=RequestSize; 

RequestSize= (BlockAddress (RequestAddress) +BlockSize) -RequestAddress; 
NextRequestSize-=RequestSize; 

NextRequestAddress=BlockAddress (RequestAddress) +BlockSize; 
NextRequest=Request ; 

} 



F (Request ! =None ) 

{ 

LastRequest=Request ; 
NumberOfAccesses [Request ] ++; 
} 



f (NextRequestSize>0) 



Ise 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★It******** 
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** Get.c ** 

* ★ * ★ 

** GetNextFileRequest ** 

* ★ * * 

** Description: ** 

★ ★ * * 

** GetNextFileRequest reads in one request, without doing any error ** 

** checking. ** 

* * ★ ★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★a-**** j 



void GetNextFileRequest ( ) 



char RequestChar=' ' , 

Chr; 

Request=None; 

if (feof (DataFile) ) EndOfDataFile=Yes; 

while (RequestChar 1=' r' && RequestChar ! =' w' && RequestChar !=' E' && 
EndOfDataFile==No && i feof (DataFile) ) 
fscanf (DataFile, "%c", &RequestChar) ; 

if (feof (DataFile) I I RequestChar==' E' ) EndOfDataFile=Yes; 

if (EndOfDataFile==No) 

{ 

fscanf (DataFile, "%1X" , &RequestAddress) ; 
fscanf (DataFile, "%u”, &RequestSize) ; 
fscanf (DataFile, "lU", &TimeOfNextRequest ) ; 

if (RequestChar==' r' ) Request=Read; 
if (RequestChar==' w' ) Request=Write; 

TimeOfNextRequest+=Time; 

while (RequestChar 1=' \n' && I feof (DataFile) ) 
fscanf (DataFile, "%c M , ^RequestChar) ; 

) 

if (feof (DataFile) ) EndOfDataFile=Yes; 



} 
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★ ★ 
★ ★ 



Description: ** 

★ ★ 

GetNextFileRequest reads in one request, without doing any error ** 
checking. ** 

★ ★ 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-A-**/ 



GetNextKeyBoardRequest () 



nar chr; 

rintf ("Please enter request type (r,w) . "); 
bile (chr!='r' && chrl='w' && chr!='q') 

{ 

scanf("%c", &chr) ; 

} 

f (chr=='q') exit(O); 

f (chr==' r' ) Request=Read; else Request=Write/ 

rintf ("Please enter Address "); 

sanf ("%U", &RequestAddress) / 

rintf ("Please enter size "); 

sanf ("%u", &RequestSize) ; 

rintf ("Time until next request. "); 

flush (stdin) / 

zanf ("%U", &TimeOfNextRequest ) ; 



imeOfNextRequest+=Time; 






★ ★ 

** Display. c 

★ * 

** Part Of SACS 1.0 

** (StillAnother Cache Simulator) 

★ * 

** Program Modified: 3/17/94 

** File Modified: 3/17/94 

★ ★ 
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Author: William G. Smith 

Address: Electrical Engineering Department 

Naval Postgraduate School 
Monterey, CA 93940 



** Copyright 1994, William G. Smith 
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★ ★ 
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Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 

This program is provided "as is” any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
user. 
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Display. c ** 

★ ★ 

Description: ★★ 



Display. c contains all display functions used within SACS. 

Table of Contents 



Cover Page Page 8- 1 

List of Cache. c Function Declarations Page 8- 2 

DisplayTrace () Page 8- 3 

DisplayCurrentRequest ( ) Page 8- 4 

DisplayWaitingFors () Page 8- 5 

DisplayBlock () Page 8- 6 

DisplayBuf fers () Page 8- 7 

DisplayBuf fer () Page 8- 8 

DisplayRequestsBreakDown () Page 8- 9 

DisplayRequestHistogramO Page 8-11 

DisplayStallHistogramO Page 8-13 

LastScreenHistogramScore () Page 8-14 

Display Cache Arguments () Page 8-15 

DisplayHelpO Page 8-17 

DisplayTestingHeader () Page 8-18 

PrintTimeO Page 8-20 

PrintTimeCentered () Page 8-20 

PrintScoreCentered ( ) Page 8-20 

PrintAddress () Page 8-20 

PrintCacheSize () Page 8-20 

PrintSizeO Page 8-20 

PrintSize2() Page 8-20 

PrintBuf f erSize ( ) Page 8-21 

PrintPriority () Page 8-21 

PrintAssociativity ( ) Page 8-21 

PrintHistogramlndex () Page 8-21 

PrintBitO Page 8-22 

PrintPercent () Page 8-22 

PrintAveAccess () Page 8-22 
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lude "Global. h 



y*******************************************************************'********** 
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List of Display. c Function Declarations 
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* ★ 
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** Description: ** 

★ * * * 

** This is a list of function declarations within the file scope ** 

** of "Display. c". ** 

* ★ * * 



***★★**★★★*★*★*★★★★★★*★*★★**★****★★★*★*★★★★★**★★★★★**★*★*★*★*★**★★*★★★★*★★★★★ j 



void 


DisplayTrace ( ) ; 


/* 
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*/ 


void 


DisplayCurrentRequest () ; 


/* 
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*/ 


void 


DisplayWaitingFors () ; 


/* 
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*/ 


void 


DisplayBlock () ; 


/* 
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*/ 


void 


DisplayBuf fers () ; 


/* 
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*/ 


void 


DisplayBuf f er ( ) ; 


/* 
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*/ 


void 


DisplayRequestsBreakDown () / 


/* 
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*/ 


void 


DisplayRequestHistogramO ; 


/* 
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void 


DisplayStallHistogramO / 


/* 
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ScoreType 


LastScreenHistogramScore () ; 


/* 
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void 


DisplayCacheArguments () ; 


/* 
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void 


DisplayHelp ( ) ; 


/* 
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*/ 


void 


DisplayTestingHeader () ; 


/* 
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*/ 


void 


Print YesNo () ; 


/* 
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*/ 


void 


PrintRequest () ; 


/* 
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*/ 


void 


PrintReplacementPolicy () ; 


/* 
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*/ 


void 


PrintWritePolicy () ; 


/* 
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*/ 


void 


PrintWriteMissPolicy () ; 


/* 
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void 


PrintWaitingFor () ; 


/* 
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void 


PrintMemoryWaitingFor () ; 


/* 
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V 


void 


PrintBlockWaitingFor () ; 


/* 
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void 


PrintTime () ; 


/* 
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void 


Print TimeCentered () ; 


/* 
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void 


PrintScoreCenteredO ; 


/* 
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void 


PrintAddress () ; 


/* 
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void 


PrintCacheSize () / 


/* 
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void 


PrintSize () ; 


/* 
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void 


PrintSize2 () ; 


/* 
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void 


PrintBuf ferSize () ; 


/* 
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void 


PrintPriority () ; 


/* 


Page 
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*/ 


void 


PrintAssociativity ( ) ; 


/* 
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*/ 


void 


PrintHistogramlndex () ; 


/* 
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*/ 


void 


PrintBit () ; 


/* 
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*/ 


void 


PrintPercent () ; 


/* 
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*/ 


void 


PrintAveAccess () / 


/* 


Page 
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*/ 
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DisplayTrace 

*★***★*★*★★***★★+*******+*+++*+**★*★★★★★**★★**+*★★★★★★★★★***+★★+++*★*+ 



DisplayTrace () 



LzeType BlockO=Set (RequestAddress) ^Associativity; 
izeType Blocklndex; 

LzeType SubBlock Index; 

/stem(ClearScreen) ; 

isplayCurrentRequest () ; 

LsplayWaitingFors () ; 

cintf (" \n ,f ) ; 

cintf (" Set Block Address "); 

Dr (SubBlockIndex=0; SubBlockIndex<NumberOf SubBlocks; SubBlockIndex++) 
print f( ,f V/D "); 
cintf ("\n" ) ; 

Dr (BlockIndex=BlockO; Block Index<BlockO+Associativity; BlockIndex++) 
DisplayBlock (Blocklndex) ; 

cintf ("\n") ; 



isplayBuf f ers () ; 



Display .c 

Display Cur rentRequest 
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★ ★ 

★ ★ 

★ ★ ★ ★ 

★ ★ Di ??nl aur.nrrpnf Rpmip.qf ★★ 

★ ★ ★ ★ 

+ + + ic + ie + ieirir + ir + irie + + + + +iririric + irir + irifir + + irir + irif + 'k'k'k'k'k'k'k'k'k'k'k’k-k-k-k'k'k'k'k'k'k-k'k-k'k'k'k'k-ie'k'k'k'k'k-k'k'k'k j 



void DisplayCurrentRequest ( ) 

{ 

if (Request !=None) LastRequest=Request ; 

if (LastRequest==None) 

{ 

RequestAddress=0; 

RequestSize=0; 

CacheHit=No; 

} 

if (Request l=None) LastRequest=Request ; 
if (CacheWait ingFor i =Nothing) 

{ 

print f (" \nCurrent Request: " ); 

} 

else 

{ 

print f (” \nLast Request: ”); 

} 

PrintRequest (LastRequest) ; 

printf(" Time: " ) ; 

PrintTime (Time) ; 

print f ("\nAddress : " ) ; 

PrintAddress (RequestAddress) ; 

printf(" Next Request Time: " ) ; 

PrintTime (TimeOfNextRequest ) ; 

print f (" \nSize : " ) ; 

PrintSize2 (RequestSize) ; 

if (MemoryWaitingFor==MemoryWaitingForMemoryReadAccess I I 
MemoryWaitingFor==MemoryWaitingForMemoryReadTransfer) 

{ 

printf( ,f TOA: ")/ 

PrintTime (TOA) ; 

} 

if (Memory Wait ingFor==Memory Wait ingForMemoryWr it eAccess | | 
MemoryWaitingFor==MemoryWaitingForMemoryWriteTransfer ) 

{ 

print f ( " TOD: ") ; 

PrintTime (TOD) ; 

} 

print f ("\n" ) ; 



} 



**★★*★*★★★***★★*************★★**★★★*★★★★★★★★★★★★★★★★★★★★•*•★■*•★★*★**★★*★■*•*★★★ 
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+ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 






DisplayWaitingFors ( ) 



>rintf ( "Cache Waiting for: 



PrintWaitingFor (CacheWaitingFor) ; 



•rintf ("\nMemory Waiting For: "); 
)rintf(" Cache Hit: 

>rintf ("\nBlock Waiting For: "); 

>rintf(" Buffer Hit: 



PrintMemoryWaitingFor (MemoryWaitingFor) ; 
" ) ; PrintYesNo (CacheHit ) ; 
PrintBlockWaitingFor (BlockWaitingFor) ; 

") ; PrintYesNo (Buf ferHit) ; 



irintf ( n \n H ); 



i 



** Darro Q — £ ★★ 



* * 
★ * 
* * 
★ ★ 



Display .c 
DisplayBlock 



Page 8- 6 



★ * 
* * 

★ ★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-* , 



void DisplayBlock (Blocklndex) 

SizeType Blocklndex; 

i 

SizeType SubBlocklndex; 

if (BlockIndex%Associativity==0) 

{ 

PrintSize (Blocklndex/Associativity) ; 

} 

else 

{ 

print f (" ”); 

} 

printf( ff "); 

PrintSize (Blocklndex) ; 
print f ( " 11 ) ; 

PrintAddress (CacheBlockAddress [Blocklndex] ) ; 

for (SubBlockIndex=0; SubBlock Index<NumberOf SubBlocks; SubBlock Index++) 

{ 

print f (" "); 

PrintBit (CacheValidBit [Blocklndex] [SubBlocklndex] ) ; 
printfC ”); 

PrintBit (CacheDirtyBit [Blocklndex] [SubBlocklndex] ) ; 
print f(" "); 

} 

print f ("\n") ; 



} 
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DisplayBuf fers 



I DisplayBuf f ers 0 



>rintf("Read Buffer "); 
(isplayBuf fer (&ReadBuf fer) ; 

>rintf ("\n") ; 

>rintf ("Write Buffer "); 
)isplayBuf fer (sWriteBuf fer) ; 

>rintf ("\n") ; 

>rintf ("Block Buffer "); 
JisplayBuffer (SBlockBuffer) ; 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A-*** 

** Page 8-8 ** 
** Display. c ** 
** * * 



** DisplayBuf fer ** 

★ * * * 

***★******★★*★*★****★***★★*★★★*★*★*★*★*★★★★★*★★★**★★★★★★★**★****★★★**★*★*•*•*★★ j 



void DisplayBuf fer (PrintBuf fer) 
Buffer Type *PrintBuf fer ; 



int R; 

print f ("Address Size Req. Block Priority"); 

printf(" Time Req. Comp. Time\n"); 

for (R=0; R<PrintBuf fer->Next ; R++) 

{ 

printf(" "); 

PrintAddress (PrintBuf fer->MemoryRequest [R] .Address) ; 
printf(" "); 

PrintSize2 (PrintBuf fer->MemoryRequest [R] . Size) ; 
print f ( " "); 

PrintSize2 (PrintBuf fer->MemoryRequest [R] .RequiredSize) ; 
print f (" "); 

PrintSize (PrintBuf fer->Memory Request [R] .Block) ; 
printf(" "); 

PrintPriority (PrintBuf fer->MemoryRequest [R] .Priority) ; 
printf(" "); 

PrintTimeCentered (PrintBuf fer->MemoryRequest [R] . TimeToExecute) ; 
print f ( " "); 

PrintTimeCentered (PrintBuf fer->MemoryRequest [R] . CompletionTimeEstimate) ; 
print f ( ” \n" ) ; 

} 



} 
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★ ★ 






★ ★★★★★★★★★•A-*.*.* 






★ ★ 
★ ★ 
* ★ 
★ ★ 

*/ 



1 DisplayRequestsBreakDown ( ) 



JcoreType 

TotalNumberOf Accesses =NumberOfAccesses [Read] +NumberOfAccesses [Write] , 
TotalNumberOfCacheHits=NumberOfCacheHits [Read] +NumberOf Cache Hits [Write] , 
TotalNumberOfBuf ferHits=NumberOfBuf ferHits [Read] +NumberOfBuf ferHits [Write] ; 
system (ClearScreen) ; 



)rintf(" \n Requests Break Down\n"); 



>rintf ("\n "); 

>rint f ( " 


Number 


Number 


Number 




>rint f ( " \n "); 

>rintf ("Request 


of 


of 


of 


Hit 


)rintf("\n "); 

)rintf(" Types 


Requests 


Cache Hits 


Buffer Hits 


Rates 



>rintf ("\n") ; 

>rint f ( " \n Read " ) ; 

>rintScoreCentered (NumberOfAccesses [Read] ) ; 
>rintf (" "); 

^intScoreCentered (NumberOfCacheHits [Read] ) ; 
>rintf (" ") ; 

'rintScoreCentered (NumberOfBuf ferHits [Read] ) ; 
.f (NumberOfAccesses [Read] >0) 

{ 



print f (" "); 

PrintPercent (NumberOfCacheHits [Read] +NumberOfBuf ferHits [Read] , 
NumberOfAccesses [Read] ) ; 



printf(" ") ; 

PrintPercent ( (NumberOfAccesses [Read] -NumberOfCacheHits [Read] ) , 
NumberOfAccesses [Read] ) ; 



> 



Miss "); 
Rates") ; 



>rintf("\n Write " ); 

> rintScoreCentered (NumberOfAccesses [Write] ) ; 
>rintf(" "); 

'rintScoreCentered (NumberOfCacheHits [Write] ) ; 
>rintf (" "); 

'rintScoreCenteredfNumberOfBuf ferHits [Write] ) ; 



-f (NumberOfAccesses [Write] >0) 



printf(" "); 

PrintPercent (NumberOfCacheHits [Write] +NurrberOfBuf ferHits [Write] , 
NumberOfAccesses [Write] ) ; 



print f(" "); 

PrintPercent ( (NumberOfAccesses [Write] -NumberOfCacheHits [Write] ) , 
NumberOfAccesses [Write] ) ; 



} 
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/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★♦★★★★★-A-* 
★ ★ 

★ * 

★ ★ ★ ★ 

** DisplayRequestBreakDown ** 

** continued ** 

★ ★ ★ ★ 



print f ( " \n Total 11 ) ; 

PrintScoreCentered (TotalNumberOf Accesses) ; 
print f( " 11 ); 

PrintScoreCentered (TotalNumberOf CacheHits) ; 
printf(" " ); 

PrintScoreCentered (TotalNumberOfBuf ferHits) ; 



if 



(TotalNumberOfAccesses>0) 

{ 

printf( lf ,f ); 

PrintPercent (TotalNumberOfCacheHits+TotalNumberOfBuf ferHits, 
TotalNumberOf Accesses) ; 
print f (" " ) ; 

PrintPercent (TotalNumberOfAccesses-TotalNumberOf CacheHits 

-TotalNumberOfBuf ferHits, 
TotalNumberOf Accesses) ; 



> 



print f ("\n") ; 

DisplayRequestHistogramO ; 



} 
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★ ★ 

DisplayRequest Histogram ** 

■*• ★ 



\ DisplayRequestHistogramO 



JizeType Timelndex; 



)rintf("\n Request Time Histogram"); 

)rintf("\n "); 

for (TimeIndex=0; TimeIndex<ScreenHistogramMaxIndex; Timelndex++) 
print f (" "); 



jrintf (" 

>rintf ("\n 
for (TimeIndex=0; 
printf ( " 



Ave " ) ; 

TimeIndex<ScreenHistogramMaxIndex; Timelndex++) 
") ; 



)rintf(" Access"); 

>rintf("\n "); 



for (TimeIndex=0; TimeIndex<ScreenHistogramMaxIndex-l; Timelndex++) 

K 

pr int f ( " Time= " ) ; 

PrintSize2 (Timelndex) ; 

1 

srintf (" Time>=") ; 

’rintSize2 (Timelndex) ; 

)rintf(" Total Time "); 
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* ★ 



* * 



* * 



DisplayRequest Histogram 
continued 



★ * 



★ * 









for (Timelndex=0; Timelndex< (ScreenHistogramMaxIndex-1) ; Timelndex++) 

< 

printf (" "); 

Print ScoreCentered (RequestTimeHistogram [Read] [Timelndex] ) ; 

} 

printf ( " "); 

PrintScoreCentered(LastScreenHistogramScore (RequestTimeHistogram [Read] ) ) ; 
printf (" "); 

PrintScoreCentered (TotalRequestTime [Read] ) ; 
printf (" M ); 

PrintAveAccess (TotalRequestTime [Read] , NumberOf Accesses [Read] ) ; 
printf ( ,f \n Write "); 

for (Timelndex=0 ; Timelndex< (ScreenHistogramMaxIndex-1) ; Timelndex++) 

{ 

printf (" "); 

PrintScoreCentered (RequestTimeHistogram[Write] [Timelndex] ) ; 

} 

printf (” " ); 

PrintScoreCentered (LastScreenHistogramScore (RequestTimeHistogram [Write] ) ) ; 
printf (" ”); 

PrintScoreCentered (TotalRequestTime [Write] ) ; 
printf (" "); 

PrintAveAccess (TotalRequestTime [Write] , NumberOfAccesses [Write] ) ; 
print f("\n Ideal ,f ) ; 

for (Timelndex=0; Timelndex< (ScreenHistogramMaxIndex-1 ) ; Timelndex++) 

{ 

printf (" "); 

PrintScoreCentered (RequestTimeHistogram [None] [Timelndex]) ; 

} 

printf (" "); 

PrintScoreCentered (LastScreenHistogramScore (RequestTimeHistogram [None] ) ) ; 
printf (" "); 

PrintScoreCentered (TotalRequestTime [None] ) ; 
printf ("\n" ) ; 



printf ("\n 



Read " ) ; 



) 
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★ ★ 
★ * 
★ ★ 



★ ★ 



★ * 

★**★★★★★★★★★*★★★★★*★★★★★★★★★★*★★★★★*★★★★★★**★★**+************************/ 



1 DisplayStallHistogram() 



.izeType Time Index; 

acheWaitingForType Stalllndex ; 

ystem(ClearScreen) ; 

rintf ("\n\n Stall Time Histogram\n\n" ) ; 

rintf (” ") ; 

or (TimeIndex=0; Time Index<ScreenHistogramMax Index-1; Timelndex++) 

{ 

print f (" Time=" ) ; 

PrintSize2 (Timelndex) ; 

} 

rintf (" Time>= H ) ; 
rintSize2 (Timelndex) ; 
rintf (” Total\n" ) ; 
rintf ("\n”) ; 

or (StallIndex=0; 

St a 11 Index <NumberOf CacheWait ingForsAvailable ; 

Stalllndex++) 

{ 

PrintWaitingFor (Stalllndex) ; 

for (TimeIndex=0; TimeIndex<ScreenHistogramMaxIndex-l; Timelndex++) 

{ 

print f ( " ,f ) ; 

PrintScoreCentered (StallTimeHistogram[StallIndex] [Timelndex] ) ; 

} 



printf(" ft ); 

PrintScoreCentered (Last ScreenHistogramScore (StallTimeHistogram [Stalllndex] ) ) ; 
print f ( " ,f ) ; 

PrintScoreCentered (TotalStallTime [Stalllndex] ) ; 
print f ("\n") ; 

} 



/*******************************************************************.********.** 
** Page 8-14 ** 



** Display. c ** 

** ** 

** LastScreenHistogramScore ** 

** ** 






ScoreType LastScreenHistogramScore (Histogram) 
TimeType *Histogram; 



T ime Type T ime I nde x ; 

ScoreType Sum=0; 

for (TimeIndex=ScreenHistogramMaxIndex-l; 
TimeIndex<FileHistogramMaxIndex; 
Timelndex++) 

Sum+=Histogram[ Time Index] ; 
return (Sum) ; 
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DisplayCacheArguments 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-A-**************** 



DisplayCacheArguments () 



ystem(ClearScreen) ; 



rintf ( " \n" ) ; 

rintf <" 

rintf ( " \n") ; 

rintf (" \nCache Size : 

rintf (" " ) ; 

rintf ("Read Forward: 

rintf ("\nBlock Size: 

rintf (" "); 

rintf ("CPU Waits For Cache Writes: 

rintf (" \nSubBlock Size : 

rintf (" "); 

rintf ("Search Block Buffer: 

rintf ( " \nAssociativity : 

rintf (" "); 

rintf ("Update Read Buffer: 

rintf (" \nWord Size: 

rintf (" "); 

rintf ("Remove Read Duplicates: 

rintf ("\nRead Cache Access Time: 

rintf (" "); 

rintf ("Remove Write Duplicates: 

rintf ("\nRead Cache Hit Time: 

rintf ( H "); 

rintf ("Read Priority: 

rintf ("\nRead Cache Miss Time: 

rintf (" "); 

rintf ("Write Priority: 

rintf ("\nWrite Cache Access Time: 

rintf (" "); 

rintf ("Read For Write Allocate: 



Cache Arguments List"); 

’ ) ; PrintCacheSize (CacheSize) ; 

' ) ; PrintYesNo (ReadForward) ; 

’ ) ; PrintSize (BlockSize) ; 

') ; PrintYesNo (CPUWaitsForCacheWrites) 
’ ) ; PrintSize (SubBlockSize) ; 

' ) ; PrintYesNo (SearchBlockBuf fer ) ; 

' ) ; PrintAssociativity (Associativity) ; 

’ ) ; PrintYesNo (UpdateReadBuf f er) ; 

’ ) ; PrintSize (WordSize) ; 

’) ; PrintYesNo (RemoveReadDuplicates) ; 

’ ) ; PrintTime (ReadCacheAccessTime) ; 

' ) ; PrintYesNo (RemoveWr it eDuplicates) ; 
1 ) ; PrintTime (ReadCacheHitTime) ; 

' ) ; PrintPriority (ReadPriority ) ; 

’ ) ; PrintTime (ReadCacheMissTime) ; 

' ) ; PrintPriority (WritePriority) ; 

' ) ; PrintTime (WriteCacheAccessTime) ; 



') 



PrintPriority (ReadForWriteAllocatePriority) ; 
rintf (" \nWrite Cache Hit Time: "); PrintTime (WriteCacheHitTime) ; 

rintf (" "); 

rintf ("Write Dirty Block Priority: ") ; 

PrintPriority (WriteDirtyBlockPriority) ; 
rintf ("\nWrite Cache Miss Time: "); PrintTime (WriteCacheMissTime) ; 

rintf (" "); 

rintf ("No Priority: "); PrintPriority (NoPriority) ; 



/* 
★ ★ 

★ ★ 
★ + 
★ ★ 
★ * 
★ ★ 
* ★ 



*★★*★★★★★★★★★★★★★★*******★****★★*******★**★****★★★***•★★★★★★*•★★★*•★★★**•★*★★*•★★ 
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DisplayCacheArguments 

continued 



★ ★ 
★ * 
★ ★ 
★ * 



*★***★*★*★*★★*★*★★**★***★*★★★*★*★★★*★**★★★**★+*★★★**★★*★*★****•*★★★**★****** 



" ) ; PrintTime (MemoryAccessTime) ; 



printf ( f 
print f ( f 



"); 

"); 

H ); 

") ; 

H ); 

")/ 



printf (" \nMemory Access Time: 
printf r ")/ 

printf ("Trace : 

f \nMemory Transfer Time: 

1 "); 

printf ("Check: 

printf ("\nBuffer Cache Access Time: 
printf (" "); 

printf ("Test : 

printf ("\nRead Buffer Size: 
printf (" "); 

printf ("Key Board 10: 
printf ("\nWrite Buffer Size: 
printf (" "); 

printf ("Data File Name: 
printf ("\nBlock Replacement Policy: 

PrintReplacementPolicy (BlockReplacementPolicy) ; 
printf (" "); 

printf ("Screen History Max Index: "); 

PrintHistogramlndex (ScreenHistogramMaxIndex) ; 
printf ("\nWrite Policy "); PrintWritePolicy (WritePolicy) ; 

printf (" "); 

printf ("File History Max Index: "); 

PrintHistogramlndex (FileHistogramMaxIndex) ; 
printf ("\nWrite Miss Policy: "); 

PrintWriteMissPolicy (WriteMissPolicy) ; 



PrintYesNo (Trace) ; 

PrintTime (MemoryTransferTime) ; 

PrintYesNo (Check) ; 

PrintTime (Buf ferCacheAccessTime) ; 

PrintYesNo (Test) ; 

PrintBuf ferSize (ReadBuf ferSize) ; 

PrintYesNo (KeyBoardIO) ; 
PrintBufferSize (WriteBuf ferSize) ; 



%s", DataFileName) ; 
,f ) ; 



printf ("\n") ; 






j 



; »■- 
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★ 



★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-** 



DisplayHelp 0 



ystem(ClearScreen) ; 




rintf (" 




Help Menu 


") 


rintf ("\n" 


) ; 






rintf ("\n 


[T] 


Trace Display: 


") 


rintf ("\n 




Displays current request, status of memory, and contents 


") 


rintf ("\n 




of buffers. 




rintf ("\n" 


) ; 






rintf ("\n 


[R] 


Results Display: 


") 


rintf ("\n 




Displays a break down of read and write cache hits, and 


") 


rintf ("\n 




buffer hits, including a timing analysis. 




rintf ("\n" 


) ; 






rintf ( ff \n 


[S] 


Stall Timing Display: 


") 


rintf ( ff \n 




Displays a histogram of the time spent on each stall. 


") 


rintf (" \n 




Stalls represent time delays in completing a request 


") 


rintf ("\n" 


); 






rintf ("\n 


[C] 


Cache Arguments Display: 


") 


rintf ("\n 




Displays input arguments to SACS. 


") 


rintf ("\n" 


); 






rintf ("\n 


[G] 


Go: Go to end of run. 


") 


rintf (" \n 


[G 


#] Go To: Go to Time #. 


") 


rintf ("\n 


[#] 


Step: Increment Time By #. 


") 


rintf ( " \n 


[-# 


] Back Step: Decrement Time By #. 


") 


rintf (" \n 


[H] 


Help: Displays this help menu. 


") 


rintf ("\n 






") 



i 
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** Display. c ** 

* ★ ★ * 



** DisplayTestmgHeader ** 

* ★ * * 



void DisplayTestingHeader ( ) 

{ 



printf ("\n" ) ; 
system (ClearScreen) ; 
printf ("\n\n") ; 

printf ("\n\n " ) ; 

printf (" Testing SACS”); 

printf ( ,f \n\n w ) ; 

printf ("Total number of loads and stores tested %lu.", 
TotalNumberOf Accesses) ; 
printf ("\n\n w ) ; 

printf (" Test Cases chosen ... "); 

printf ("\n\n") ; 



} 
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Print Enumeration Stings 

^★★♦★★★★★★★★* + * + *** + ****** + *** + * + + + *******-*-- *★★★★ 



1 PrintYesNo (Value) 

TesNoType Value; 

I 

)rintf ("%s", YesNoString [Value] ) ; 



i PrintRequest (Value) 
lequestType Value; 

)rintf ("%s", Requeststring [Value] ) ; 



i PrintReplacementPolicy (Value) 
SlockReplacementPolicyType Value; 

)rintf ("%s", ReplacementPolicyString [Value] ) ; 



1 PrintWritePolicy (Value) 

JritePolicyType Value; 

>rintf ("Is", WritePolicyString [Value] ) ; 



1 PrintWriteMissPolicy (Value) 
JriteMissPolicyType Value; 

)rintf ("%s\ WriteMissPolicyString [Value] ) ; 



1 PrintWaitingFor (Value) 

^acheWaitingForType Value; 

)rintf ("Is", CacheWaitingFor St ring [Value] ) ; 



1 PrintMemoryWaitingFor (Value) 
lemory Wait ingFor Type Value; 



>rintf ("%s",MemoryWaitingForString [Value] ) ; 



1 PrintBlockWaitingFor (Value) 
JlockWaitingForType Value; 

>rintf ("%s", BlockWaitingForString [Value] ) ; 
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★ ★ 

★ * 

★ ★ ★ ★ 

** Print Routines ** 

★ * ★* 



void PrintTime (Time) 
TimeType Time; 

{ 



if 




<Time>=10000000) 


printf ("%81u 


else 


if 


(Time>=1000000 


) 


printf ("%71u 


else 


if 


(Time>=100000 


) 


printf ("%61u 


else 


if 


(Time>=10000 


) 


printf ("%51u 


else 


if 


(Time>=1000 


) 


printf ("%41u 


else 


if 


(Time>=100 


) 


printf ("%31u 


else 

else 


if 


(Time>=10 


) 


printf ("%21u 
printf ("%llu 



' , Time) ; 

", Time) ; 

" , Time) ; 

", Time) ; 

", Time) ; 

", Time) / 

" , Time) ; 



} 



void PrintTimeCentered (Time) 

TimeType Time; 

{ 

if (Time>=1000000) printf ("%81u", Time) ; 

else if (Time>=10000 ) printf ("%71u ",Time); 

else if (Time>=100 ) printf ("%61u ",Time); 

else printf ("%51u ",Time); 

} 



void PrintScoreCentered (Score) 

ScoreType Score; 

{ 

if (Time>= K 1000000) printf ("%81u". Score) ; 

else if (Time>=10000 ) printf ("%71u ”, Score); 

else if (Time>=100 ) printf ("%61u 

else 

} 



printf ("%51u 



", Score) ; 
", Score) ; 



void PrintAddress (Address) 
Address Type Address; 

{ 

printf ("I081X", Address) ; 

} 

void PrintCacheSize (CacheSize) 
Caches izeType CacheSize; 

{ 

printf ( " %081u" , CacheSize) ; 

} 

void PrintSize (Size) 

SizeType Size; 

{ 

printf ("%05u" , Size) ; 

} 



void PrintSize2 (Size) 
SizeType Size; 
i 

printf ("%02u". Size) ; 

} 



***★★*★**★★★*★★*★*★*★*★**★*★★★★★*★*★★*★*★★★*★*★*★★★★★★★★★★★★★**★*★**★★★*** 
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★ ★ 
★ * 



Print Routines 
continued 



★ ★ 

*★*★★★★★★★*★★★★***★+**★**★★★*★★★★★★*★★*★★*★★**★*★*★★★★★****★★★★★★★★*★★***/ 



PrintBuf ferSize (Buf ferSize) 
ifferSizeType BufferSize; 

cintf ("%02u", Buf ferSize) ; 

PrintPriority (Priority) 
riorityType Priority; 

rintf ("%02u", Priority) ; 

PrintAssociativity (Associativity) 
ssociativityType Associativity; 

rintf ("%02u”, Associativity) ; 

PrintHistogramlndex (Histogramlndex) 
istogramlndexType Histogramlndex; 

rintf ("%04u", Histogramlndex) ; 




Page 8-22 
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Display . c 



★ ★ 



★ ★ 



★ ★ 



Print Routines 
continued 






★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■a-** 



void PrintBit (Bit ) 

YesNoType Bit; 

{ 

print f ("%01u". Bit ) ; 

} 

void PrintPercent (Numerator, Denominator) 

ScoreType Numerator; 

ScoreType Denominator; 

{ 

if (Denommator>0) 

{ 

printf ("%6.21f ,f , (100 . 0*Numerator) /Denominator) ; 
print f ( "% " ) ; 



void PrintAveAccess (TotalTime, TotalNumberof Accesses) 

TimeType TotalTime; 

ScoreType TotalNumberofAccesses; 

{ 

if (TotalNumberofAccesses>0) 

{ 

printf ( n %8 . 61 f " , (1 . 0*TotalTime) /TotalNumberofAccesses) ; 



else 



printf (" 



t» 



) ; 



else 



printf (" 



it 



) ; 



*•★★★★★★★★★★★★★★★★+***'*■***★***★*★★★***'*■★★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-***** 
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★ ★ 

Part Of SACS 1.0 ** 

(StillAnother Cache Simulator) ** 

★ ★ 

Program Modified: 3/17/94 ** 

File Modified: 3/17/94 ** 

★ ★ 

Author: William G. Smith ** 

Address: Electrical Engineering Department ** 

Naval Postgraduate School ** 

Monterey, CA 93940 ** 

★ ★ 

Copyright 1994, William G. Smith ** 

* ★ 

Permission to use, copy, modify, and distribute this software and ** 

its documentation for any purpose and without fee is hereby granted ** 

provided that the above copyright notice appears in all copies. No ** 

modified version of this program should be redistributed without the ** 

authors consent. William G. Smith makes no warranty or ** 

representation, promise of guarantee, either expressed or implied, ** 

with respect to this software's ability to produce valid results. ** 

This program is provided M as is” any financial, personal or property ** 

damage caused by the use of this program is the responsibility of the ** 

user. ** 

★ ★ 






★ ★ 
★ ★ 
★ * 
★ ★ 
•k ★ 



Record. c 
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Description: 



★ ★ 
★ ★ 
★ ★ 
★ 



★ ★ * ★ 

** Record. c contains all functions that relate to the recording of ** 

** time for requests, and waiting fors, as well as a procedure for saving ** 
** the data in a file using a format that Matlab(TM) could read. ** 

★ * ★ ★ 

** Table of Contents ** 

★ ★ ★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
* * 



Cover Page 

List of Record. c Function Declarations 

RecordRequest ( ) 

RecordStall () 

RecordForMatlab ( ) 
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★ ★ 
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9- 2 


★ ★ 




9- 3 


★ ★ 




9- 5 


★ ★ 
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9- 7 


★ ★ 



* ★ 






♦include " Global. h" 






Record. c 
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★ ★ 

★ * 



List of Record. c Function Declarations ** 

★ * 

Description: ** 

★ ★ 

This is a list of function declarations within the file scope ** 

of "Record. c". ** 

★ ★ 



a.*************************************************************************/ 



i RecordRequest () ; 
i RecordStall () ; 

3 RecordForMatlab () ; 



/* Page 9- 3 */ 
/* Page 9- 5 */ 
/* Page 9- 7 */ 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A:*** 

** Page 9- 3 ** 



** Record. c ** 

★ * * ★ 

** Record Request ** 

★ * ★ * 

** Description: ** 

★ * ★ ★ 



** RecordRequest records the time spent on a particular request and ** 
** stores the result in RequestTimeHistogram. ** 
* * ★ ★ 
★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-** j 



void RecordRequest (Req) 

RequestType Req; 

{ 

static TimeType LastTime=l; 

static TimeType Lastdt=0; 

static RequestType LastReq=NumberOfRequestsAvailable; 

TimeType dt=Time-LastTime ; 

if (Req==NumberOfRequestsAvailable) 

{ 

LastTime=l; 

Lastdt=0; 

LastReq=Req; 

} 

else if (Req==LastReq) 

{ 

TotalRequestTime [LastReq] -=Lastdt; 

if (Lastdt>FileHistogramMaxIndex-l ) Lastdt=FileHistogramMaxIndex-l; 
RequestTimeHistogram [LastReq] [Lastdt ] — ; 

} 

else if (LastReq! =NumberOfRequestsAvailable) 

{ 

LastTime=Time; 

dt=0; 

NumberOfCacheHits [LastReq] +=CacheHit; 

NumberOfBuf ferHits [LastReq] +=Buf ferHit; 

} 



LastReq=Req; 



***★★★****★***★*★*****★*★*★*★*★**★★★★★**★★******★★★*★★★***★*★★**★*★★*****★★ 

Page 9- 4 ** 
★ * 

★ ★ 
★ ★ 
* ★ 
★ ★ 

*★★★*★*******★*★********★+★*****★**********★★★★★★*★**★**★+*★*****★***★*★**/ 



Record. c 

Record Request 
continued 



Lf (Req! =NumberOfRequestsAvailable) 

{ 

TotalRequestTime [Req] +=dt; 

Lastdt=dt / 

if (dt>FileHistogramMax Index-1) dt=FileHistogramMaxIndex-l; 
if (Time>=LastTime) 

{ 

RequestTimeHistogram[Req] [dt] ++; 

} 

else 

{ 

print f ("\n\nError [RecordRequest ] caculated a time less than 0”); 
print f ("\n\n Time = " ) ; Print Time (Time) ; 

print f ( ,f \n\nLastTime = "); PrintTime (LastTime) ; 
printf ( " \n\n ,f ) ; 

DiscrepancyFound=Yes; 



\ 



> 






* ★ 

★ ★ 

*•* ★ ★ 
** RecordStall ** 



Record. c 
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★ ★ 



★ ★ 
* * 
★ ★ 
* ★ 



Description: 



★ ★ 
★ ★ 
* * 



RecordStall records the time spent on a particular waiting for and ** 
** stores the result in StallTimeHistogram. ** 
* * * ★ 



void RecordStall (CurrentWaitingFor) 

CacheWaitingForType CurrentWaitingFor; 

{ 

static TimeType PastTime=l; 

static TimeType Pastdt=0; 

static CacheWaitingForType PastWaitingFor=None; 

TimeType dt=Time-Pas tTime ; 

if (CurrentWaitingFor==NumberOfCacheWaitingForsAvailable) 

{ 

PastTime=l; 

Pastdt=0; 

PastWaitingFor=CurrentWaitingFor; 

} 

else if (CurrentWaitingFor==PastWaitingFor) 

{ 

TotalStallTime [PastWaitingFor ] -=Pastdt; 

if (Pastdt>FileHistogramMaxIndex-l) Pastdt=FileHistogramMaxIndex-l; 
StallTimeHistogram[PastWaitingFor] [Pastdt J — ; 

} 

else if (PastWaitingFor ! =NumberOfCacheWaitingForsAvailable) 

{ 

PastTime=Time ; 
dt=0; 

} 

PastWaitingFor=CurrentWaitingFor; 



★**★★★★★****★★*★***★*★★*★★★**★★★★★★★*★★★★*★**★★**★★★★★★★★***★*★★***★★★★★★★★ 
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★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 



RecordStall 

continued 



★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★a -* j 



if (CurrentWaitingFor 1 =NumberOfCacheWait ingForsAvailable) 

< 

TotalStallTime [CurrentWaitingFor] +=dt ; 

Pastdt=dt ; 

if (dt>FileHistogramMaxIndex-l) dt=FileHistogramMaxIndex-l; 
if (Time>=PastTime) 

StallTimeHistogram [CurrentWaitingFor] [dt ] ++; 



{ 

printf (”\n\nError [RecordStall] calculated a time less than 0"); 
printf ("\n\n Time = "); PrintTime(Time); 
printf ( ff \n\nPastTime = "); PrintTime (PastTime) ; 
printf ("\n\n"); 

DiscrepancyFound=Yes; 



else 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A-** 
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** Record. c ** 

★ ★ ★ ★ 

** RecordForMatlab ** 

★ ★ ★ ★ 

** Description: ** 

* ★ ★ ★ 

** RecordForMatlab saves the RequestTimeHistogram, and ** 

** StallTimeHistograms in a format that Matlab(TM) reconizes. ** 

★ ★ ★ ★ 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★- a -* 1 



void RecordForMatlab ( ) 



CacheWaitingForType Stall Index; 

Request Type Request Index; 

int Column, 

NumberOf Columns=2 ; 

HistogramlndexType Histogramlndex; 

FILE *MatlabOut ; 

if ( (Mat labOut=f open ( "timing. m M , "w") )==NULL) 

{ 

printf(”Can not open matlab output file.”); 

} 

for (Request lndex=0; Request Index<NumberOf Request sAvailable; Request Index++) 

{ 

fprintf (MatlabOut, "%s= [ ", Requeststring [Request Index] ) ; 

fprintf (MatlabOut, ” %081u”, RequestTimeHistogram [Request Index] [0] ) ; 

Column=l; 

for (HistogramIndex=l ; 

His togramIndex<Fi leHi st ogramMax Index; 

HistogramIndex++) 

{ 

Column++; 

if (Column>NumberOf Columns) 

{ 

Column=l; 

fprintf (MatlabOut, ”, \n " ) ; 

} 

else 

{ 

fprintf (MatlabOut, ", ”) ; 

} 

fprintf (MatlabOut, " %081u", 

RequestTimeHistogram [Request Index] [Histogramlndex] ) ; 

} 



fprintf (MatlabOut, " ] ; \n\n” ) ; 



} 
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* * 
+ * 
★ * 
* ★ 



RecordForMat lab 
Continued 



★ ★ 



for (Stalllndex^O; StallIndex<NumberOfCacheWaitingForsAvailable; Stalllndex++) 

{ 

fprintf (MatlabOut, "%s- [ " , CacheWaitingForString [Stalllndex] ) ; 
fprintf (MatlabOut, " %081u", StallTimeHistogram [Stalllndex] [0] ) ; 

Column=l; 

for (HistogramIndex=l; 

HistogramIndex<FileHistogramMaxIndex; 

HistogramIndex++) 

{ 

Column++; 

if (Coluinn>NuinberOf Columns ) 

{ 

Column=l ; 

fprintf (MatlabOut, ", \n " ) ; 



else 

{ 

fprintf (MatlabOut, ; 

} 

fprintf (MatlabOut, " %081u" , 



StallTimeHistogram [Stalllndex] [Histogramlndex] ) ; 



fprintf (MatlabOut, "] / \n\n") ; 



Eclose (MatlabOut ) ; 



/★★*★★★★★★*★★★★★★★★***★************★*******************★★**★* 
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* ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 



Buffer . c 

Part Of SACS 1.0 
(StillAnother Cache Simulator) 

Program Modified: 3/17/94 
File Modified: 3/17/94 

Author: William G. Smith 

Address: Electrical Engineering Department 

Naval Postgraduate School 
Monterey, CA 93940 

Copyright 1994, William G. Smith 
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★ ★ 
★ ★ 
★ ★ 
* ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
* * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ * 



★ * 
★ * 
★ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
* * 



Permission to use, copy, modify, and distribute this software and ** 
its documentation for any purpose and without fee is hereby granted ** 
provided that the above copyright notice appears in all copies. No ** 
modified version of this program should be redistributed without the ** 
authors consent. William G. Smith makes no warranty or ** 
representation, promise of guarantee, either expressed or implied, ** 
with respect to this software's ability to produce valid results. ** 
This program is provided "as is" any financial, personal or property ** 
damage caused by the use of this program is the responsibility of the ** 
user. ** 



* * ★ * 



i 
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★ ★ 

★ * 
★ ★ 

Buffer. c contains all functions that relate to the management of ** 
the Read, Write, and Block Buffers. ** 



Description : 



Table of Contents 

Cover Page 

List of Cache. c Function Declarations 

Push() 

Pop() 

ChangeTopMemoryRequest () 

Append () 

View() 

Clear () 

Order () 

Splice () 

Search () 

UpdatingReadBuf fer () 

RemoveZeroSizes () 

NoRequestsLeft () 
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, elude "Global. h" 






/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-A-**** 
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** Buffer. c ** 

* * ★ * 

** List of Buffer.c Function Declarations ** 

* * 

★ * 
★ ★ 
★ ★ 
* ★ 

★ ★ ★ ★ 



* * 

** Description: 

★ ★ 

** This is a list of functions declarations within the file scope 

** of "Buffer.c”. 



void 


Push () ; 


/* 


Page 


10- 3 


*/ 


MemoryRequestType 


Pop() ; 


/* 


Page 


10- 4 


*/ 


void 


ChangeTopMemoryRequest () ; 


/* 


Page 


10- 5 


*/ 


void 


Append ( ) ; 


/* 
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*/ 


MemoryRequestType 


View () ; 


/* 


Page 


10- 7 


*/ 


void 


Clear ( ) ; 


/* 


Page 


10- 8 


*/ 


void 


Order ( ) ; 


/* 


Page 


10- 9 


*/ 


void 


Splice () ; 


/* 


Page 


10-10 


*/ 


YesNoType 


Search () ; 


/* 


Page 


10-12 


*/ 


YesNoType 


UpdatingReadBuf fer () ; 


/* 


Page 


10-13 


*/ 


void 


RemoveZeroSizes () ; 


/* 


Page 


10-15 


*/ 


YesNoType 


NoRequestsLeft () ; 


/* 
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10-16 


*/ 



* Page 10-3 ** 

* Buffer. c ** 

^ ★ ★ 

* Push ** 

■ ★ ★ 

* Description: ** 

^ * * 

* Push adds a new record to the top of the buffer. ** 

i, ★ ★ 

**★★★★★★★★★***★*★★★***★********★*******★*★★★★*★*★*★★★★★★*★***★**★★★★★★■*■★★★★ j 



:d Push (Buffer, Memory Request) 

BufferType *Buffer; 

MemoryRequest Type *MemoryReques t ; 

{ 

Buf ferSizeType i; 

if (Buf f er->Full) 

{ 

CacheWaitingFor=Buf fer->WaitingForFlag; 

J 

else 

K 

for (i=Buf f er->Next / i>0; i — ) 

Buf f er->MemoryRequest [i] =Buf fer->MemoryRequest [i-1] ; 

Buf fer->Next++; 

Buf fer->MemoryRequest [0] =*MemoryRequest; 
if (Buf f er->Next>Buf fer->Max) Buf fer->Full=Yes; 

Buf f er->Empty=No; 

if (CacheWaitingFor==Buf fer->WaitingForFlag) CacheWaitingFor=Nothing; 

} 

} 



i 
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** Buffer. c ** 

*★ ** 

★ * 
★ ★ 
* * 
★ * 



★ * 
★ * 



Pop 



** Description: 

★ ★ 

** Pop removes a record from the top of the buffer, and returns it to ** 

** the caller of the function. ** 

** ** 



MemoryRequestType Pop (Buffer) 
Buf ferType *Buf fer; 



MemoryRequestType MemoryRequest ; 

Buf ferSizeType i; 

if (Buf fer->Empty I I Buf fer->Next==0) 

{ 

printf ("\n\n Tryed to Pop an empty buffer ! \n\n") ; 
exit ( 1 ) ; 

} 

else 

{ 

MemoryRequest=Buf fer->MemoryRequest [0] ; 
for (i=0; i<Buf fer->Next ; i++) 

Buf fer->MemoryRequest [i]=Buf fer->MemoryRequest [i+1] ; 
Buf fer->Next — / 

if (Buf fer->Next==0) Buf fer->Empty=Yes; 

Buf fer->Full=No; 

} 

return (MemoryRequest) ; 



} 



Buffer .c 



ChangeTopMemoryRequest 



Description : 

Push adds a new record to the top of the buffer. 






id ChangeTopMemoryRequest (Buffer, MemoryRequest ) 

BufferType *Buf fer; 

MemoryRequestType *MemoryRequest ; 



if (Buf fer— >Empty~No && Buf fer->Next>0) 

{ 

Buf f er->MemoryRequest [ 0 ] =* MemoryRequest ; 

} 

else 

{ 

print f ("\n\n Tryed to Pop an empty buf fer ! \n\n" ) ; 
exit (1) ; 




★ + 



Page 10- 6 



Buffer . c 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 



★ ★ 



Append 



Description : 



★ * 



Append adds a new record to the bottom of the buffer. 






if (Buf f er->Full) 

{ 

CacheWaitingFor=Buf fer->WaitingForFlag; 

} 

else 

{ 

Buf fer->MemoryRequest [Buf f er->Next ] =*MemoryRequest ; 

Buf f er— >Next++; 

if (Buf fer->Next>Buf fer->Max) Buf f er->Full=Yes; 

Buf fer->Empty=No; 

if (CacheWaitingFor==Buf fer->WaitingForFlag) CacheWaitingFor=Nothing; 

} 



void Append (Buf fer, MemoryRequest ) 



Buf f erType *Buf fer; 
MemoryRequestType ^MemoryRequest ; 



} 



Buffer . c 



Page 



View 

Description : 

View returns a copy of the top record in the buffer without 
altering the buffer. 



:oryRequestType View (Buffer) 
Buf ferType *Buf fer; 



MemoryRequestType MemoryRequest ; 

if (Buffer->Empty) 

{ 

printf(”\n\n Tryed to View an empty buffer 1 \n\n”) ; 
exit (1) ; 

} 

else 

{ 

MemoryRequest=Buf fer->MemoryRequest [0] ; 

} 



return (MemoryRequest ) ; 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★I**-******* 
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** Buffer. c ** 

★ ★ ★ 

** Clear ** 

★ ★ ★ ★ 

** Description: ** 

★ ★ ★ ★ 

** Clear removes all entrees in the buffer. ** 

★ ★ ★ ★ 



void Clear (Buffer) 

Buf ferType *Buf f er; 

{ 

Buf fer->Next=0; 

Buf f er->Full=No; 

Buf f er->Empty=Yes ; 

} 



jt 

Buffer . c 
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Order 



Description: 



I 

Order sorts all of the entries in the buffer by priority such 
that the highest priority (lowest priority number) is at the top. 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 






■id Order (Buffer) 

BufferType *Buffer; 

{ 

MemoryRequestType TmpMemoryRequest; 

YesNoType Change=Yes; 

Buf ferSizeType i; 

while ( ! (Buf fer->Empty) && Change) 

{ 

Change=No; 

for (i=Buf fer->Next-l; i>0; i — ) 

{ 

if (Buf fer->MemoryRequest [i] .Priority< 

Buf fer->MemoryRequest [i-1] .Priority) 

{ 

TmpMemoryRequest=Buf fer->MemoryRequest [i] ; 

Buf fer->MemoryRequest [i] =Buf fer->MemoryRequest [i-1] ; 
Buf f er->MemoryRequest [ i-1 ] =TmpMemoryRequest ; 
Change=Yes; 

} 

} 

} 



} 



^★★★★★★★★★★★★★★★★★************************************ + + *****************'*'**** 
** Page 10-10 ** 

** Buffer. c ** 

★ ★ 

** Splice 

★ ★ 



* * 
★ ★ 
★ * 



** Description: 

★ ★ 

** Splice is buffer utility that takes a one byte memory request and 

** enters it into a buffer if the buffer does not already have the byte. 

** Splice will first searchthe ReadBuffer for the byte if it can't find a 
** request in the buffer that contains the byte then it will search for a 
** memory request that has data from the same block. If one is found 
** then the request is modified to include the new read byte request. 

** If no suitable request can be found then Splice will add a one byte 

** memory request to the Buffer. 

★ ★ 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•a-* 



* * 
★ * 
★ ★ 
★ ★ 
★ * 
★ * 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 

★ ★ j 



void Splice (Buffer, Address, RequiredSize, Block, Priority) 



Buf ferType 

AddressType 

SizeType 

SizeType 

PriorityType 

{ 



*Buf fer; 

Address; 

RequiredSize; 

Block; 

Priority; 



Buf fer SizeType 

YesNoType 

AddressType 

AddressType 

AddressType 

SizeType 



Buf ferlndex; 

FoundByte=No; 

FrontAddress; 

BackAddress; 

CurrentBlockAddress=BlockAddress (Address) , 
NextSize; 



MemoryRequestType Memory Request; 

MemoryRequest .Address = Address; 

MemoryRequest . Size = 1; 

MemoryRequest . RequiredSize = 0; 

MemoryRequest .Block = Block; 

MemoryRequest .Priority = Priority; 

MemoryRequest . AccessInProgress = No; 

MemoryRequest . TimeToExecute = 0; 

MemoryRequest . CompletionTimeEstimate = 0; 

if (RequiredSize>0 ) MemoryRequest .RequiredSize=l ; 



*★★★★★★★★*★***★*★ + ★***** + ***** + **** + ***************★ + *★★★★★★★*★*★★*★★★★*★•*•★ 



Buf fer . c 

Splice 

continued 
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★ ★ 
★ ★ 
★ * 
★ * 






if ( i (Buf fer->Empty) ) 

{ 

for (Buf ferlndex=0; Buf f erIndex<Buf fer->Next; Buf ferlndex++) 

{ 

if (BlockAddress (Buf fer->MemoryRequest [Buf ferlndex] .Address) — 
CurrentBlockAddress) 



{ 

NextSize=l; 

FrontAddress=Buf fer->MemoryRequest [Buf ferlndex] .Address; 
BackAddress =FrontAddress; 

while (FoundByte==No && NextSize<=BlockSize && 

NextSize<- (Buf fer->MemoryRequest [Buf ferlndex] . Size+1) ) 

{ 

if (BackAddress==Address) 

{ 

if (NextSize>Buf fer->MemoryRequest [Buf ferlndex] . Size) 

Buf f er— >MemoryRequest [Buf ferlndex] . Size=NextSize; 
if (RequiredSize>0) 

Buf fer->MemoryRequest [Buf ferlndex] . RequiredSize=NextSize; 
if (Buf fer->MemoryRequest [Buf ferlndex] .Priority>Priority) 

Buf fer->MemoryRequest [Buf ferlndex] .Priority=Priority; 
FoundByte=Yes ; 

} 

if (FrontAddress==Address && 

Buf f er— >MemoryRequest [Buf ferlndex] . AccessInProgress==No) 

{ 

Buf fer->MemoryRequest [Buf ferlndex] . Size=NextSize; 
if ( Requ i r edS i ze > 0 ) 

Buf f er->MemoryRequest [Buf ferlndex] .RequiredSize++; 
if (Buf f er->MemoryRequest [Buf ferlndex] .Priority>Priority) 

Buf f er->MemoryRequest [Buf ferlndex] .Priority=Priority; 
FoundByte=Yes ; 

} 

NextSize++; 

if (NextSize>Buf fer->MemoryRequest [Buf ferlndex] .Size) 

Front Address — ; 

BackAddress++; 

if (BlockAddress (FrontAddress) 1 =CurrentBlockAddress) 

Front Address+=BlockSize; 

if (BlockAddress (BackAddress) 1 =CurrentBlockAddress) 
BackAddress-=BlockSize; 

> 

if (Buf fer->MemoryRequest [Buf ferlndex] . Size==BlockSize && 

Buf fer->MemoryRequest [Buf ferlndex] . AccessInProgress==No) 

{ 

Buf fer->MemoryRequest [Buf ferlndex] .Address=Request Address; 

Buf fer->MemoryRequest [Buf ferlndex] .RequiredSize=RequestSize; 

} 

} 

} 

} 

if (Found£yte==No) Append (Buffer, &MemoryRequest ) ; 

} 
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** Buffer. c ** 

★ * ** 

** Search ** 

★ ★ ★ ★ 

** Description: . ** 

★ ★ ★ ★ 

** Search checks a buffer to see if it contains a byte addressed by ** 

** Address. ** 

★ ★ ★ ★ 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★a- j 



YesNoType Search (Buff er, Address) 



Buf ferType *Buf fer; 

AddressType Address; 

{ 



Buf ferSizeType 

AddressType 

AddressType 

SizeType 

YesNoType 



Buf ferlndex; 

ByteAddress; 

CurrentBlockAddress=BlockAddress (Address) 
NoBytes; 

FoundByte=No; 



if (! (Buffer->Empty) ) 

{ 

for (Buf f erlndex=0 ; Buf ferIndex<Buf f er->Next ; Buf ferlndex++) 

{ 

if (BlockAddress (Buf fer“->Memory Request [Buf ferlndex] .Address) == 
CurrentBlockAddress ) 

{ 

ByteAddress=Buf fer->MemoryRequest [Buf ferlndex] .Address; 
for (NoBytes=0; 

NoBytes<Buf f er->MemoryRequest [Buf ferlndex] .Size; 
NoBytes++) 

{ 

if (ByteAddress==Address) FoundByte=Yes; 

By t e Addre s s 4-+ ; 

if (BlockAddress (ByteAddress) ! =CurrentBlockAddress) 
ByteAddress-=BlockSize ; 

} 

) 

} 

} 



return (FoundByte) ; 



} 



♦ ►★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-* 



* Page 10-13 

* Buffer. c 

* 

* Upda t ingReadBu f f er 

* 

* Description: 

* 

Upda t ingReadBu f fer takes a byte of data provided by a CPU write 

* reqeust and checks to see if it is needed in the read buffer. If the 

* byte is needed then the MemoryRequest is modified so that the byte 

* is no longer in the request. 

* 



★ ★ 
★ ★ 
* * 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 






stfoType UpdatingReadBuf fer (Address) 

Address Type Address; 

{ 

kddr e s s Type By t eAddr e s s ; 

AddressType CurrentBlockAddress = BlockAddress (Address) ; 

Buf ferSizeType Bufferlndex; 

YesNoType FoundByte = No; 



j 



Buffer . c 



Page 10-14 ** 

★ ★ 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★a-*** 
* ★ 

★ ★ 

★ ★ * ★ 

** UpdatingReadBuf fer ** 

** continued ** 

* ★ * * 

*★★*★**★★★★★★*★★****★**★******★****★★★*★★★*★*******★**★★★**★***★*★*★★*★*★★**★/ 



if ( I (ReadBuffer .Empty) ) 

{ 

for (Buf f erlndex=0; Buf ferIndex<ReadBuf fer .Next; Buf ferlndex++) 

{ 

if (BlockAddress (ReadBuf f er .MemoryRequest [Buf ferlndex] .Address) == 
CurrentBlockAddress 

&& ReadBuf fer .MemoryRequest [Buf ferlndex] .AccessInProgress==No) 

{ 

if (ReadBuf fer .MemoryRequest [Buf ferlndex] .Size>0) 

{ 

ByteAddress=ReadBuf fer .MemoryRequest [Buf ferlndex] .Address + 

ReadBuf fer .MemoryRequest [Buf ferlndex] .Size - 1; 

if (ByteAddress==Address) 

i 

ReadBuf fer .MemoryRequest [Buf ferlndex] .Size — ; 
if (ReadBuf fer .MemoryRequest [Buf ferlndex] .RequiredSize> 

ReadBuf fer .MemoryRequest [Buf ferlndex] . Size) 

ReadBuf fer .MemoryRequest [Buf ferlndex] .RequiredSize= 

ReadBuf fer .MemoryRequest [Buf ferlndex] . Size; 
FoundByte=Yes; 

} 

} 

if (ReadBuf fer .MemoryRequest [Buf ferlndex] .Size>0) 

{ 

if (ReadBuf fer .MemoryRequest [Buf ferlndex] . Address^Address) 

{ 

ReadBuf fer .MemoryRequest [Buf ferlndex] .Address++; 
if (BlockAddress (ReadBuf fer .MemoryRequest [Buf ferlndex] .Address) 
! =CurrentBlockAddress) 

ReadBuf fer .MemoryRequest [Buf ferlndex] . Address-=BlockSize; 
if (ReadBuf fer .MemoryRequest [Buf ferlndex] .Size >0) 

ReadBuf fer .MemoryRequest [Buf ferlndex] . Size — ; 
if (ReadBuf fer .MemoryRequest [Buf ferlndex] .RequiredSize>0) 
ReadBuffer .MemoryRequest [Buf ferlndex] .RequiredSize — ; 
FoundByte=Yes; 

} 

} 

} 

} 

} 

RemoveZeroSizes (&ReadBuf fer) ; 
return (FoundByte) ; 



} 



#★★*★**********★****★★★★********★***************★*********★★★★★★★★★*★★★■*•*★★★ 
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Buffer. c 
Remove ZeroSizes 



★ ★ 
★ * 
★ * 
★ ★ 
★ ★ 



★ * 
★ * 



•* Description: 

RemoveZeroSizes removes all entrees that have a zero size from ** 

the buffer. ** 

★ * 

• * *★*★★★★★★**’*•**★*•★★★**•*★★*•★★★*★★★★★★★★■*■★★★★★★★*■*■*★★★*★★★***★★★*★*★*★★★*★*** j 



c d RemoveZeroSizes (Buffer) 



BufferType *Buffer; 



< 



Buf ferSizeType i=0; 

Buf ferSizeType j=0; 

while ( j<Buf fer->Next ) 



if (Buf fer->MemoryRequest [ j ] .Size==0 && 

!Buf fer->MemoryRequest [ j ] .Access InProgress) 

< 

j++; 

Buf fer->Full=No; 

> 

else 

< 

Buf f er— >MemoryRequest [i] =Buf fer->MemoryRequest [ j] ; 
i++; 

j++; 

} 



} 

Buf f er->Next=i; 

if (Buf f er— >Next==0) Buf fer->Empty=Yes; 

} 



** Page 10-16 ** 

** Buffer. c ** 

★ ★ * 

* * 



NoRequestsLeft 

* * 

* * 

★ ★ 

** NoRequestsLeft returns Yes if there are no more requests left 

** in the buffer. 



Description : 



* * 
* ★ 
* * 
★ 

★ * 

^ * ★ 

★ * * * 



YesNoType NoRequestsLeft (Buffer) 
Buf f erType *Buf fer; 



Buf ferSizeType i; 

for (i=0; i<Buf fer->Next ; i++) 

{ 

if (Buf fer->MemoryRequest [i] .RequiredSize>0) return (No) ; 

} 

return (Yes) ; 



\ 
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Part Of SACS 1.0 
(StillAnother Cache Simulator) 

Program Modified: 3/17/94 
File Modified: 3/17/94 

Author: William G. Smith 

Address: Electrical Engineering Department 

Naval Postgraduate School 
Monterey, CA 93940 

Copyright 1994, William G. Smith 

Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 

This program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 



'★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-a-* 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 
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Description : 



Array. c contains all functions that relate to definition and 
** freeing, or allocation, and deallocation of arrays. 



★ ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



★ * 


Table of Contents 








★ * 


★ ★ 










★ ★ 


★ ★ 


Cover Page 
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1 


★ ★ 


★ ★ 


List of Array. c Function Declarations 
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11- 


2 


★ ★ 


★ 


DefineArraylD () 
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11- 


3 


★ ★ 


★ ★ 


Def ineArray2D ( ) 


Page 


11- 


4 


★ ★ 


★ ★ 


FreeArraylD ( ) 


Page 


11- 


5 


★ ★ 


★ ★ 


FreeArray2D () 


Page 


11- 


6 


★ ★ 


★ ★ 










★ ★ 




★★★★★★★★★ 


★★*★★★★*★★★★★ j 
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*< Array.c 

i 

■■! . , 

Description: 



List of Array.c Function Declarations 



★ ★ 
★ ★ 
★ ★ 



This is a list of function declarations within the file scope ** 
v of ’’Array.c" . ** 
ri | ★ ★ 



li *Def ineArraylD ( ) ; 
Li **Def ineArray2D ( ) ; 
n d FreeArray ID ( ) ; 
n.d FreeArray2D ( ) ; 



f* 


Page 


11- 3 


*/ 


/* 


Page 


11- 4 


*/ 


/* 


Page 


11- 5 


*/ 


/* 


Page 


11- 6 


*/ 






/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★a-* 

** Page 11- 3 ** 

** Array. c ** 

* ★ ★ * 

** Def ineArraylD ** 

** Description: ** 

★ ★ ★★ 

** Def ineArraylD allocates memory large enough for a 1 dimensional ** 

** array of length Xmax, where each element has "size’ 1 bytes. ** 

★ ★ ★ ★ 



int *Def ineArraylD (Xmax, size) 

unsigned Xmax; 
unsigned size; 

{ 

int *Array; 

Arrays (int*) calloc (Xmax, size) ; 
return (Array) ; 

} 



j k ★ ★ ★ 1 






Array . c 
Def ineArray2D 
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★ ★ 



* Description: 



★ ★ 
★ ★ 
★ ★ 



Def ineArray2D allocates memory large enough for a 2 dimensional 
array Xmax, by Ymax, where each element has "size" bytes. 












it **Def ineArray2D (Xmax, Ymax, size) 

unsigned Xmax; 
unsigned Ymax; 
unsigned size; 



{ 

int ** Array; 

unsigned x; 

Array= (int**) calloc (Xmax, size) ; 

for (x=0; x<Xmax; x++) Array [x] = (int * ) calloc (Ymax, size) ; 
return (Array) ; 



} 



★ ★ 
★ ★ 
★ ★ 
★ ★ 






Array . c 
FreeArraylD 



★ ★ 
★ ★ 



► ★★★★★★★★★★★★★★★★★★★★★★★•A- 

Page 11-5 ** 

★ ★ 

★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 

FreeArraylD deallocates the memory assigned to the 1 dimensional ** 

★ ★ 

★ ★ 



Description: 



array . 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-* 



void FreeArraylD (Array, Xmax) 
int *Array; 



free (Array) ; 

} 






/ 



* Page 11- 6 

* Array. c 

H, 

FreeArray2D 

Description : 

FreeArray2D deallocates the memory assigned to the 2 dimensional 
array. 



★ ★ 
★ ★ 
★ ★ 
★ ★ 



★ ★ 
★ ★ 

★ ★ ★ j 



>id FreeArray2D (Array, Xmax, Ymax) 

int **Array; 

unsigned Xmax; 
unsigned Ymax; 

{ 

unsigned x; 

for (x=0; x<Xmax; x++) free (Array [x] ) ; 
free (Array) ; 

\ 



/ * * 
★ ★ 

* * 

* ★ 



*★★★★★★★★*★★****★★★★★*★★***★*★**★★★★***★★*********★★★★★★★★*•★*★★★★★★★★★★★★ 
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★ * 
★ * 
* ★ 
★ ★ 



** Part Of SACS 1.0 , ** 
** (StillAnother Cache Simulator) ** 
* * * * 

** Program Modified: 3/17/94 ** 
** File Modified: 3/17/94 ** 
★ ★ * * 



** Author: William G. Smith 

** Address: Electrical Engineering Department 

** Naval Postgraduate School 



** Monterey, CA 93940 ** 

★ ★ ★ ★ 

** Copyright 1994, William G. Smith ** 

* ★ ★ ★ 



★ ★ 
★ ★ 
★ ★ 



★ ★ 
★ ★ 



* ★ 



Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 

This program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
user . 



* ★ 
★ ★ 
★ * 




★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 






/ 
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TestSACS . c 



Description : 



TestSACS randomly creates instructions and writes them to 
"SACS .Dat " . The instrcutions are generated by first choosing 
NoTestCases . The Number of test cases to be used will always 
be less than MaxNoTestCases . Then the TestCaseChoosen is picked 
from TestCases. TestCases represent different possible ways in 
which an address trace could procede. PredictedNoRead, HitsInTest, 
and PredictedNoWriteHitsInTest, tells TestSACS how many hits it can 
expect because, it used a specific test. 

Example : 



* ★ * ★ ★ 

1 ** 
★ ★ 

★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



main ( ) 

< 



unsigned long int NoLoadHits; 
unsigned long int NoLoadRequests ; 

TestSACS (NumberOfRequests, NumberOfHits ) 



print f ("\n\nNumber of 
print f ( " \n\nNumber of 
print f ("\n\nNumber of 
printf ("\n\nNumber of 



read hits=%ul" , NoReadHits) ; 
read requests=%ul" , NoReadRequests) ; 
write hits=%ul",NoWriteHits) ; 
write requests=%ul",NoWriteRequests) 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 



Table of Contents 



List of TestSACS. c Function Declarations 
TestCases 



Creating One Instruciton at a Time 
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★ ★ 
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15 


★ ★ 















i.nclude<time . h> 



Lnclude " Global. h 
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** TestSACS.c ** 

★ ★ ★ ★ 

** Description: ** 

* * ★ ★ 

** List of definitions. ** 

* ★ ★★ 



♦define MaxNoOfTestCases 



3 /* Can be changed without other changes. */ 



♦define NoTestCaseChoices 64 /* // Need to change TestCases, and */ 



♦define NoLoadStoresInTestCases 7 /* \\ PredictedNoHitsInTest 

♦define IrandO ((unsigned long) ( (rand() *0xl0001+rand () ) *0xl0001+rand ( ) ) ) 









k 

k 

k 
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List of TestSACS. c Function Declarations 



Page 12- 3 



* Description: 

★ 

* This is a list of functions declarations within the file scope 

* of "TestSACS. c" . 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
* ★ 
★ ★ 
★ * 
★ ★ 






oid 


ChangeArguments () ; 


/* 


Page 


12- 6 


*/ 


oid 


TestSACS () ; 


/* 


Page 


12- 8 


*/ 


oid 


CreatelnstructionSets () ; 


/* 


Page 


12- 9 


*/ 


oid 


Shuf flinglnstructionSets () ; 


/* 


Page 


12-12 


*/ 


esNoType 


CanBeSwitched () ; 


/* 


Page 


12-14 


*/ 


oid 


WritelnstructionSet () ; 


/* 


Page 


12-15 


*/ 



j ★ ★ ★ ★ i 
★ ★ 



r ★ ★ ★ ★ ★ 1 



★ * 
★ ★ 
★ * 
* * 



TestSACS . c 
TestCases 
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★ ★ 



★ ★ 
★ ★ 
★ * 



** Description: 

★ ★ 

** Loading Test Cases, the each nuinber is an indexe for an array of 

** BlockAddressChoices . 

★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ * 
★ ★ 









j 

:< 



int TestCases [NoTestCaseChoices ] [NoLoadStoresInTestCases ] = 
{ 



{ 


1, 


1, 


1, 


1, 


1, 


1, 


1}, 


{ 


1, 


i. 


1, 


1, 


1, 


1, 


2}, 


{ 


1, 


1, 


1, 


1, 


1, 


2, 


1}, 


{ 


1, 


1 , 


1, 


1, 


1, 


2, 


2}, 


< 


1, 


1, 


1, 


1, 


2, 


1, 


1}, 


{ 


1, 


i. 


1, 


1, 


2, 


1, 


2}, 


{ 


1, 


1, 


1, 


1, 


2, 


2, 


1}, 


{ 


1, 


i. 


1, 


1, 


2, 


2, 


2}, 


{ 


1, 


1, 


1, 


2, 


1, 


1, 


1}, 


{ 


: l. 


i, 


1, 


2, 


1, 


1, 


2}, 


{ 


1, 


1, 


1, 


2, 


1, 


2, 


1}, 


{ 


i. 


1 , 


1, 


2, 


1, 


2, 


2}, 


{ 


1, 


1, 


1, 


2, 


2, 


1, 


1}, 


{ 


i. 


i. 


1, 


2, 


2, 


1, 


2}. 


{ 


1, 


1, 


1, 


2, 


2, 


2, 


1), 


{ 


i. 


1 , 


1, 


2, 


2, 


2, 


2}, 


{ 


1, 


1, 


2, 


1, 


1, 


1, 


1}, 


< 


i. 


1 , 


2, 


1, 


1, 


1, 


2}, 


{ 


1, 


1, 


2, 


1, 


1, 


2, 


1}, 


{ 


i. 


1 , 


2, 


1, 


1, 


2, 


2}, 


{ 


1, 


1, 


2, 


1, 


2, 


1, 


1}, 


{ 


i. 


1 , 


2, 


1, 


2, 


1, 


2}, 


{ 


1, 


1, 


2, 


1, 


2, 


2, 


1), 


{ 


i. 


1 , 


2, 


1, 


2, 


2, 


2}, 


f 


1, 


1, 


2, 


2, 


1, 


1, 


1}, 


{ 


i. 


1 , 


2, 


2, 


1, 


1, 


2}, 


{ 


1, 


1, 


2, 


2, 


1, 


2, 


1}, 


{ 


l. 


1 , 


2, 


2, 


1, 


2, 


2), 


{ 


1, 


1, 


2, 


2, 


2, 


1, 


1}, 


< 


i. 


1 , 


2, 


2, 


2, 


1, 


2}, 


f 


1, 


1, 


2, 


2, 


2, 


2, 


1}, 


{ 


1 , 


1 , 


2, 


2, 


2, 


2, 


2), 


f 


1, 


2, 


1, 


1, 


1, 


1, 


1}, 


{ 


i. 


2, 


1, 


1, 


1, 


1, 


2}, 


f 


1, 


2, 


1, 


1, 


1, 


2, 


1), 


{ 


i. 


2, 


1, 


1, 


1, 


2, 


2}, 


{ 


1, 


2, 


1, 


1, 


2, 


1, 


1}, 


{ 


1 , 


2, 


1, 


1, 


2, 


1, 


2), 


{ 


1, 


2, 


1, 


1, 


2, 


2, 


1), 


{ 


i. 


2, 


1, 


1, 


2, 


2, 


2}, 


f 


1, 


2, 


1, 


2, 


1, 


1, 


1), 


{ 


i. 


2, 


1, 


2, 


1, 


1, 


2}, 


{ 


1, 


2, 


1, 


2, 


1, 


2, 


1), 


{ 


1 , 


2, 


1, 


2, 


1, 


2, 


2), 


{ 


1, 


2, 


1, 


2, 


2, 


1, 


1}, 


< 


1 , 


2, 


1, 


2, 


2, 


1, 


2}, 


f 


1, 


2, 


1, 


2, 


2, 


2, 


1}, 


{ 


i. 


2, 


1, 


2, 


2, 


2, 


2}, 


{ 


1, 


2, 


2, 


1, 


1, 


1, 


1}, 


< 


i. 


2, 


2, 


1, 


1, 


1, 


2}, 


f 


1, 


2, 


2, 


1, 


1, 


2, 


1), 


{ 


i. 


2, 


2, 


1, 


1, 


2, 


2}, 


{ 


1, 


2, 


2, 


1, 


2, 


l, 


1), 


< 


i. 


2, 


2, 


1, 


2, 


1, 


2}, 


f 


1, 


2, 


2, 


1, 


2, 


2, 


1), 


< 


1 , 


2, 


2, 


1, 


2, 


2, 


2}, 


f 


1, 


2, 


2, 


2, 


1, 


1, 


1}, 


{ 


i. 


2, 


2, 


2, 


1, 


1, 


2}, 


{ 


1, 


2, 


2, 


2, 


1, 


2, 


1}, 


{ 


i. 


2, 


2, 


2, 


1, 


2, 


2}, 


{ 


1, 


2, 


2, 


2, 


2, 


1, 


1}, 


{ 


1 , 


2, 


2, 


2, 


2, 


1, 


2), 


{ 


1, 


2, 


2, 


2, 


2, 


2, 


1}, 


{ 


i. 


2, 


2, 


2, 


2, 


2, 


2} 



}; 
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★ ★ 

PredictedNoReadHits, and PredictedNoWriteHits ** 

★ ★ 

Description: ** 

★ ★ 

No Hits Predicted for each test case. ** 

★ ★ 



int PredictedNoReadHitsInTest [NoTestCaseChoices ] = 

{ 

6, 5, 5, 4, 

5, 4, 4, 3, 

5, 4, 4, 3, 

4, 3, 3, 2, 

5, 4, 4, 3, 

4, 3, 3, 2, 

4, 3, 3, 2, 

3, 2, 2, 1, 

5, 4, 4, 3, 

4, 3, 3, 2, 

4, 3, 3, 2, 

3, 2, 2, 1, 

4, 3, 3, 2, 

3, 2, 2, 1/ 

3, 2, 2 / 1/ 

2 , 1 , 1 , 0 

}; 



int PredictedNoWriteHitsInTest [NoTestCaseChoices]® 

{ 

0 / 0 , 0 , 1 / 

0 , 1 , 1 , 2 , 

0 , 1 , 1 , 2 , 

1, 2, 2, 3, 

0 , 1 , 1 , 2 , 

1, 2, 2, 3, 

1, 2, 2, 3, 

2, 3, 3, 4, 

0 , 1 , 1 , 2 , 

1 1 2 / 2 , 3 / 

1, 2, 2, 3, 

2, 3, 3, 4, 

1, 2, 2, 3, 

2 r 3, 3, 4, 

2, 3, 3, 4, 

3, 4, 4, 5 

}; 



★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 



Change Argument s 
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** TestSACS.c ** 

★ ★ * * 

★ ★ 
★ ★ 
★ * 
★ ★ 

ChangeArguments, change the global variables in SACS that the ** 

** user can change. ** 

★ + ★ ★ 

**********+********+***★★★★★★★★★+★★★★★★★★★★★★★★★★★★★★*★★★*★*★**++**+*+**★****/ 



Description : 



void ChangeArguments ( ) 



< 



SizeType WordSizeLimit = 8 
SizeType WordsPerSubBlock = 4 
SizeType NumberOfSubB locks Limit = 4 
SizeType NumberOfBlocksLimit = 32 
AssociativityType AssociativityLimit =* 8 
Buf ferSizeType Buf ferSizeLimit = 8 
TimeType TimeLimit = 8 



WordSize 

SubBlockSize 

BlockSize 



(rand () % (WordSizeLimit-1) ) +1; 

WordSize* ( (rand ( ) %WordsPerSubBlock) +1) ; 
SubBlockSize 

* ( (rand () %NumberOf SubBlocksLimit ) +1) ; 



Associativity 

CacheSize 



= (randO %AssociativityLimit ) +2; 

= BlockSize*Associativity* 

( (rand () ^NumberOfBlocksLimit ) +1) ; 



ReadCacheAccessTime 
ReadCacheHitTime 
ReadCacheMissTime 
WriteCacheAccessTime 
Writ eCacheHit Time 
WriteCacheMissTime 
Memo ryAc cess Time 
MemoryTrans f erTime 
Buf ferCacheAccessTime 



= rand ( ) %TimeLimit ; 
= rand () %TimeLimit ; 
= randO %TimeLimit; 
= rand () %TimeLimit; 
= rand ( ) % TimeLimit ; 
= rand () %TimeLimit; 
= rand ( ) %TimeLinu_t ; 
= rand () oTimeLimit; 
= rand () %TimeLimit ; 



ReadBuf ferSize 
WriteBuf ferSize 



(rand () %Buf ferSizeLimit) +1; 
(rand () %Buf ferSizeLimit ) +1; 



BlockReplacementPolicy 
WritePolicy 
WriteMissPolicy 
ReadForward 
CPUWaitsForCacheWrites 
SearchBlockBuf fer 
UpdateReadBuf fer 
RemoveReadDuplicates 
Remove Writ eDuplicates 



= rand() %NumberOfReplacementPoliciesAvailable; 
= rand () %NumberOfWritePoliciesAvailable; 

= randO %NumberOfWriteMissPoliciesAvailable; 

= rand ( ) ^Unknown; 

= rand () %Unknown; 

= rand () %Unknown; 

= rand () %Unknown; 

= rand () %Unknown; 

= randO ^Unknown; 



ReadPriority 

WritePriority 

ReadForWriteAllocatePriority 

WriteDirtyBlockPriority 



(rand () % (NoPriority-1) ) +1; 
(rand () % (NoPriority-1) ) +1; 
(rand () % (NoPrionty-1) ) +1; 
(rand ( ) % (NoPriority-1) ) +1; 



TestSACS . c 



Description: 



Change Argument s 
continued 



Ensuring that the new arguments are valid combinations 

★ ★★★★★★★★★★★★★★★★★★★★★★♦★★★★★★★★★★★♦★★★★♦★♦★★★★★★★♦★♦♦♦★♦★★■A-* 



if (SearchBlockBuf fer==No) RemoveReadDuplicates=No; 



if (UpdateReadBuf fer ==Yes) WordSize=SubBlockSize; 



/★★★★★★★★★★★★★★★★★★★★★★★*★*****★****★**********★******★★★★★★'*★★★★★★★★★★•*•★★★★■*■★ 
** Page 12- 8 ** 

** TestSACS.c ** 

★ ★ ★* 

** TestSACS ** 

★ ★ ★ ★ 

** Description: ** 

★ ★ ★* 

** TestSACS will create a test set, shuffle the instructions, and ** 

** write them out to "SACS . Dat " . ** 

★ ★ ★ ★ 



void TestSACS (NumberOfRequests, NumberOfHits) 

ScoreType *NumberOfRequests ; 

ScoreType *NumberOfHits; 

{ 

char Request [MaxNoOfTestCases*NoTestCaseChoices+l] ; 

AddressType DataAddress [MaxNoOfTestCases*NoTestCaseChoices+l] ; 

SizeType Size [MaxNoOfTestCases*NoTestCaseChoices+l] ; 

TimeType TimeUntilNextRequest [MaxNoOfTestCases*NoTestCaseChoices+l ] ; 

int lmax=0; 

DisplayTestingHeader () ; 

CreatelnstructionSets (Request, DataAddress, Size, TimeUntilNextRequest, 

&Imax, 

NumberOfRequests, NumberOfHits) ; 

Shuf flinglnstructionSets (Request, DataAddress, Size, TimeUntilNextRequest, 

Imax) ; 

rewind (DataFile) ; 

WritelnstructionSet (Request, DataAddress, Size, TimeUntilNextRequest, 

Imax) ; 

rewind (DataFile) ; 

EndOfDataFile=No ; 

} 



★ ★★★★★★★★★★♦★★★★★★★★★★★★★★★★★★★★★★♦♦★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★Ik-* 



r Description: 



TestSACS . c 

Create Ins tructionSets 
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★ ★ 

★ ★ 



★ * 
★ ★ 



* The instructions are created from a set of test cases. The 
> the number of predicted hits for each case is stored in 

* PredictedNoHitsInTest. CreatelnstructionsSets randomly chooses the 

* NoOfTestCases to be used, and randomly selects the individual 

* TestCases. The BlockAddressChoices for each test case is also chosen 

* randomly. The DataAddress, and Size of each instuction is chosen 

* randomly such that they are within the block chosen. The NoLoadHits 

* is predicted by summing up all of the PredictedNoHitsInTest. 






/ 



Did CreatelnstructionSets (Request, 

DataAddress, 

Size, 

TimeUntilNextRequest, 

Imax, 

NumberOfRequests, 

NumberOfHits) 



char 

AddressType 
SizeType 
Time Type 
int 

ScoreType 

ScoreType 



♦Request; 

♦DataAddress; 

♦Size; 

♦TimeUntilNextRequest; 

♦Imax; 

♦NumberOfRequests ; 
♦NumberOfHits ; 



{ 



TimeType MaxTimeUnt ilNextRequest = 101; 

AddressType BlockAddressChoices [NumberOfRequestsAvailable] ; 
SizeType Set Chosen; 

int TestCaselndex; 
int Loadlndex; 
int NoOfTestCases; 
int TestCaseChosen; 
int i, j, k; 



time_t t; 

srand ( (unsigned) time(&t)); ♦/ /♦ 

/♦ 

/* 

/* 

/* 



Uncomment to randomize each test run ♦/ 
otherwise every test run will be */ 
identical. Leaving the seed */ 
commented out allows any errors ♦/ 
found by -test to be revisited. ♦/ 



NumberOfRequests [Read ]=0; 
NumberOfRequests [Write] =0; 
NumberOfHits [Read ]=0; 
NumberOfHits [Write] =0; 
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★ * 



★ ★ 
★ ★ 

CreatedlnstrutionSets ** 

Continued ** 

★ ★ 

Description: ** 

★ ★ 

Creating one instruction at a time. ** 

★ ★ 



*lmax=0; 

NoOfTestCases=rand ( ) %MaxNoOfTestCases+l; 

for (TestCaseIndex=0; TestCaseIndex<NoOfTestCases; TestCaseIndex++) 

{ 

Test CaseChosen=rand ( ) %NoTestCaseChoices ; 

SetChosen=rand ( ) %NumberOf Sets ; 

BlockAddressChoices [Read] = 

( ( (lrand ( ) / (NoOfTestCases*NumberOf Sets*BlockSize) ) 
*NoOfTestCases+TestCaseIndex) 

*NumberOf Sets + SetChosen) * BlockSize; 

BlockAddressChoices [Write] =BlockAddressChoices [Read] ; 
if (rand()%2) 

BlockAddressChoices [Write] = 

( ( (IrandO / (NoOfTestCases*NumberOfSets*BlockSize) ) 
*NoOfTestCases+TestCaseIndex) 

*NumberOfSets + SetChosen) * BlockSize; 

if (BlockAddress (BlockAddressChoices [Read] ) ! ^BlockAddressChoices [Read] ) 
printf ("Read is not a BlockAddress”); 
if (BlockAddress (BlockAddressChoices [Write] ) ! =BlockAddressChoices [Write] ) 
printf ("Write is not a BlockAddress”); 

if (Set (BlockAddressChoices [Read] ) ! =SetChosen) 
printf ("Read is not a good Set"); 

if (Set (BlockAddressChoices [Write] ) !=SetChosen) 
printf ("Write is not a good Set"); 

if (BlockAddressChoices [Read] ==BlockAddressChoices [Write] ) 
printf (" %4dE" , Tes tCas eChos en) ; 
else 

printf ("%4dN", TestCaseChosen) ; 
if (TestCaseIndex%15==14) printf <"\n") ; 



+ + + + + + + + + + + + + + + + + * + * + + * + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 



* 

★ 
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★ ★ 



★ ★ 



CreatedlnstrutionSets 

Continued 



★ ★ 
★ ★ 
★ ★ 






if (BlockAddressChoices [Read] ==BlockAddressChoices [Write] ) 

i 

NumberOfHits [Read] +=PredictedNoReadHitsInTest [TestCaseChosen] / 
NumberOfHits [Write] +=PredictedNoWriteHitsInTest [TestCaseChosen] ; 



LoadIndex=0; 

while (TestCases [TestCaseChosen] [Loadlndex] ==Write && 
WriteMissPolicy i =WriteAllocate && 

LoadIndex<NoLoadStoresInTest Cases) 

{ 

NumberOfHits [Write] — ; 

LoadIndex++; 

} 

if (TestCases [TestCaseChosen] [0]==Read && TestCaseChosen ! =0) 
NumberOfHits [Write] ++; 
if (TestCases [TestCaseChosen] [0]==Write && 
WriteMissPolicy==WriteAllocate) 

NumberOfHits [Read] ++ ; 

} 

else 

{ 

NumberOfHits [Read] +=PredictedNoReacLHitsInTest [TestCaseChosen] ; 
if (WriteMissPolicy==WriteAllocate) 

NumberOfHits [Write] +=PredictedNoWriteHitsInTest [TestCaseChosen] ; 



for (LoadIndex=0; LoadIndex<NoLoadStores InTest Cases ; LoadIndex+*f ) 

{ 

if (TestCases [TestCaseChosen] [Loadlndex] ==Read) 

{ 

Request [*Imax] =' r' ; 

NumberOfRequests [Read] ++; 

} 

else 

{ 

Request [ * I max ] =' w' ; 

NumberOfRequests [Write] ++; 

} 



DataAddress [*Imax] = 

BlockAddressChoices [TestCases [TestCaseChosen] [Loadlndex] ] ; 

Size [*Imax]=lrand() %BlockSize+l; 
if (Size [*Imax] <BlockSize) 

DataAddress [ *Imax] += lrand ( ) % (BlockSize-Size [ *Imax] ) +1; 
TimeUntilNextRequest [ *Imax] =lrand () %MaxTimeUntilNextRequest ; 

( *lmax) ++; 

} 

} 

} 






★ ★ 
★ ★ 
•k ★ 
* ★ 
★ ★ 



TestSACS.c 
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★ * 



Description: 



Shuffling Instruction Sets. 



★ ★ 
* ★ 
★ ★ 
★ * 
★ ★ 
★ ★ 
★ ★ 









void Shuf f linglnstructionSets (Request, 

DataAddress, 

Size, 

TimeUntilNextRequest, 

Imax) 

char * Request; 

AddressType *DataAddress ; 

SizeType *Size; 

TimeType *TimeUntilNextRequest ; 

int Imax; 

{ 

int 
char 

AddressType 
SizeType 
TimeType 
int i, j, k; 



Jump; 

RequestTemp; 

AddressTemp; 

SizeTemp; 

TimeTemp; 






TestSACS . c 
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★ ★ 

★ ★ 



Shuf f linglnstructionSets ** 

continued ** 

★ ★ 



for (i=l; i<Imax; i++) 

{ 

Jump=Yes; 

for (j=i; j>0 && Jump==Yes; j — ) 

{ 

if (BlockAddress (DataAddress [ j] ) ==BlockAddress (DataAddress [ j-1] ) ) 
Jump=No; 



if ( (rand() % (Associativity*NoLoadStoresInTestCases) )==0) 
Jump=No; /* Gives Uniform distrabution . */ 

if ( Jump==Yes) 

Jump=CanBeSwitched (DataAddress, j, Imax) ; 

if (Jump==Yes) 

{ 

RequestTemp=Request [j-1] ; 

Request [ j-l]=Request [ j] ; 

Request [ j ] =RequestTemp; 

AddressTemp=DataAddress [ j-1] / 

DataAddress [ j-1 ] =DataAddress [ j ] ; 

DataAddress [ j ] =AddressTemp; 

SizeTemp=Size [ j-1 ] ; 

Size [ j-1 ] =Size [ j ] ; 

Size [ j ] =SizeTemp; 

TimeTemp=TimeUntilNextRequest [ j-1 ] ; 
TimeUntilNextRequest [j-1 ] =TimeUntilNextRequest [ j ] ; 
TimeUntilNextRequest [ j ] =TimeTemp; 

} 

} 

} 

} 



/******************•***★★★*★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 
** Page 12-14 ** 

CanBeSwitched ** 

★ ★ 



* * 

★ ★ 

** DESCRIPTION: 

+ * 

*+ Can InstructionAddress [i] be switched with Instruction [ i— 1 ] 

** If so return Yes, else return No. 



★ ★ 
★ ★ 
★ * 
★ * 

** *★ 
★ *★★★★ + ★*★★★★ + ★★*★★★★ + ********** + + *** + + *********** + ********* + ** + * + *** + *★*'*■•*•★* j 



YesNoType CanBeSwitched (DataAddress, Io, Imax) 
unsigned long int *DataAddress; 
int Io; 

int Imax; 



{ 



int 

YesNoType 
YesNoType 
YesNoType 
unsigned long int 



i/ j; 

Jump=Yes ; 

NoJumped; 
JumpedBefore; 
Address Jumped [100] ; 



Jump=Yes; 

NoJumped=l; 

Address Jumped[0] =BlockAddress (DataAddress [ Io] ) ; 
i=Io-2; 

while (i>=0 && NoJumped<Associativity && 

BlockAddress (DataAddress [i] ) ! =BlockAddress (DataAddress [Io-l] ) ) 

{ 

JumpedBef ore=No; 

for (j=0; j<NoJumped; j++) 

if (Address Jumped [ j ] ==BlockAddress (DataAddress [i] ) ) JumpedBefore=Yes; 
if ( JumpedBef ore==No && NoJumped<Associativity) 

Address Jumped [No Jumped++] =BlockAddress (DataAddress [i] ) ; 
i — ; 

} 

if (NoJumped>=Associativity) Jump=No; 



NoJumped=l; 

Address Jumped [0] =BlockAddress (DataAddress [Io-l] ) ; 
i=Io+l; 

while (i<Imax && No Jumped<Associativity && 

BlockAddress (DataAddress [i] ) l=BlockAddress (DataAddress [Io] ) ) 

{ 

JumpedBef ore=No; 

for (j=0; j<NoJumped; j++) 

if (Address Jumped [ j ] ==BlockAddress (DataAddress [i] ) ) JumpedBef or e= Yes; 
if (JumpedBef ore==No && NoJumped<Associativity) 

Address Jumped [No Jumped++] =BlockAddress (DataAddress [i] ) ; 
i++; 

} 

if (NoJumped>=Associat ivity ) Jump=No; 
return (Jump) ; 



} 
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I* 

* Write Ins tructionSet 



* Description: 

★ 

* Write SACS.Dat one line at a time. 






oid Writelnstruct lonSet (Request , 

DataAddress, 

Size, 

TimeUntilNext Request, 
Imax) 

I 

char * Request; 

AddressType *DataAddress ; 

SizeType *Size; 

TimeType *TimeUntilNextRequest ; 
int Imax; 



{ 



int i; 



for (i=0; i<Imax; i++) 

{ 

fprintf (DataFile, "%c ,f 
fprintf (DataFile, n %081X 
fprintf (DataFile, "%2u " 
fprintf (DataFile, "%lu" 
fprintf (DataFile, ff \n ff ) ; 
} 



, Request [i] ) ; 

, DataAddress [ i ] ) ; 

, Size [i] ) ; 

, TimeUntilNextRequest [i] ) 



fprintf (DataFile, f, End Of Trace\n\n" ) ; 
fprintf (DataFile, "If any instructions follow\n"); 
fprintf (DataFile, "they were not used for the\n"); 
fprintf (DataFile, " last run . \n" ) ; 

fprintf (DataFile, "\n") ; 



! ★ ★ 
★ ★ 
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Checking . c 



★ ★ 
★ ★ 
★ ★ 



★ * 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 

★ "k 

★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 



Part Of SACS 1.0 
(StillAnother Cache Simulator) 

Program Modified: 3/17/94 
File Modified: 3/17/94 

Author: William G. Smith 

Address: Electrical Engineering Department 

Naval Postgraduate School 
Monterey, CA 93940 

Copyright 1994, William G. Smith 

Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 

This program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
user. 



★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 
★ ★ 

★ ★ 
★ ★ 
★ * 
★ ★ 






kr * ★ ★ ★ ★ i 









* 

! 
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k 



Description : 

Checking. c contains all of the functions that relate to error 
checking. Note that an error could be raised anywhere. The error 
mesage will contain the procedure name in square brackets. This 
section contains the functions spicifically designed to check variable 
to see if they are consitant with each other, and if they are within 
set boundarys. 



Table of Contents 



Cover Page Page 13-1 

List of Cache. c Function Declarations Page 13- 2 

Checking () Page 13- 3 

CheckingConstants ( ) Page 13- 4 

PrintConstError () Page 13-11 

CheckingForValuesOutOfBounds ( ) Page 13-12 

PrintTimeBoundaryError () ; Page 13-15 

Print ScoreBoundaryError () ; Page 13-16 

Print SizeBoundaryError () ; Page 13-17 

PrintEnumBoundaryError ( ) ; Page 13-18 

CheckingForlnconsistencies () Page 13-19 

PrintTotalTimeError () Page 13-21 

PrintTotalScoreError () Page 13-22 

CheckingPredictions () Page 13-23 

Print ScorePredictionError () Page 13-24 

PrintTimePredictionError () Page 13-25 






include "Global. h 



★ * 

★ ★ 

★ ★ 

★ ★ 

** Description 
★ ★ 

★ ★ 
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List of Checking. c Function Declarations 
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* 

★ * 
★ ★ 
★ ★ 
★ ★ 
*★ 
★ ★ 
★ ★ 

* ★ ** 



This is a list of function declarations witnin the file scope 
** of "Checking. c" . 






void 


Checking () ; 


/* 


Page 


13- 3 


*/ 


void 


CheckingConstants () ; 


/* 


Page 


13- 4 


*/ 


void 


PrintConstError () ; 


/* 


Page 


13-11 


*/ 


void 


CheckingForValuesOutOfBounds () ; 


/* 


Page 


13-12 


*/ 


void 


Print TimeBoundaryError () ; 


/* 


Page 


13-15 


*/ 


void 


Print ScoreBoundaryError () ; 


/* 


Page 


13-16 


V 


void 


Print SizeBoundaryError () ; 


/* 


Page 


13-17 


V 


void 


PrintEnumBoundaryError () ; 


/* 


Page 


13-18 


*/ 


void 


CheckingForlnconsistencies () ; 


/* 


Page 


13-19 


*/ 


void 


Print TotalTimeError () ; 


/* 


Page 


13-21 


*/ 


void 


PrintTotalScoreError () ; 


/* 


Page 


13-22 


*/ 


void 


CheckingPredictions () ; 


/* 


Page 


13-23 


*/ 


void 


PrintScorePredictionError () ; 


/* 


Page 


13-24 


*/ 


void 


PrintTimePredictionError () ; 


/* 


Page 


13-25 


*/ 






★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★♦★★★★★It 
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Checking. c ** 

★ ★ 

Checking ** 



r Description: 



r Checking checks the global variables to insure that constants ** 
l r remain constant, and Values are in bounds, als that there are no ** 
I inconsistencies. ** 

t ★ ★ 
*★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★*★ j 



Did Checking () 
{ 



CheckingConstants (No) ; 
CheckingForValuesOutOfBounds () ; 
CheckingForlnconsistencies () ; 

} 



/★★★★★★★★★★★★★★★★★★★★*★★★*****★******************•*■*■★**★*★*★***★★*★★★★★★★★★★★★★ 
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★ ★ 
★ ★ 



★ ★ 

CheckingConstant s * * 

★ ★ 



** Description: 

★ ★ 

** Checking global constants to insure that they do not change, 

** unless they are being Reset. 

★ ★ 



★ ★ 
★ * 
★ ★ 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A-***- ^ 



void CheckingConstants (Reset ) 



YesNoType Reset; 



{ 

static CacheSizeType 
static SizeType 
static SizeType 
static AssociativityType 
static SizeType 

static TimeType 
static TimeType 
static TimeType 
static TimeType 
static TimeType 
static TimeType 

static TimeType 
static TimeType 
static TimeType 

static Buf ferSizeType 
static Buf ferSizeType 



CacheSizeCopy; 

BlockSizeCopy; 

SubBlockSizeCopy; 

AssociativityCopy; 

WordSizeCopy; 

ReadCacheAccessTimeCopy; 

ReadCacheHitTimeCopy; 

ReadCacheMissTimeCopy; 

WriteCacheAccessTimeCopy; 

WriteCacheHitTimeCopy; 

WriteCacheMissTimeCopy; 

MemoryAccessTimeCopy; 

MemoryTransferTimeCopy; 

Buf ferCacheAccessTimeCopy; 

ReadBuf ferSizeCopy; 
WriteBuf ferSizeCopy; 



static BlockReplacementPolicyType BlockReplacementPolicyCopy; 



static WritePolicyType 
static WriteMissPolicyType 
static YesNoType 
static YesNoType 
static YesNoType 
static YesNoType 
static YesNoType 
static YesNoType 



WritePolicyCopy; 
WriteMissPolicyCopy; 
ReadForwardCopy; 
CPUWaitsForCacheWritesCopy; 
SearchBlockBuf ferCopy; 
UpdateReadBuf ferCopy; 

Remo veRe adDupl i cates Copy ; 
RemoveWriteDuplicatesCopy; 



static PriorityType 
static PriorityType 
static PriorityType 
static PriorityType 
static PriorityType 



ReadPriorityCopy; 

WritePriorityCopy; 

ReadForWriteAllocatePriorityCopy; 

WriteDirtyBlockPriorityCopy; 

NoPriorityCopy; 



static YesNoType 



CheckCopy; 



static YesNoType 
static char 



KeyBoardlOCopy; 

*DataFileNameCopy; 



static HistogramlndexType ScreenHistogramMaxIndexCopy; 

static HistogramlndexType FileHistogramMaxIndexCopy; 
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CheckingConstants 

continued 



static SizeType 
static SizeType 
static SizeType 


NumberOfBlocksCopy; 
NumberOf SubBlocksCopy ; 
NumberOfSetsCopy; 


static AddressType 
static TimeType 


*CacheBlockAddressCopy; 

*LastCacheBlockAccessTimeCopy; 


static SizeType 


*CacheNextBlockCopy; 


static YesNoType 
static YesNoType 


**CacheValidBitCopy; 

**CacheDirtyBitCopy; 


static TimeType 
static TimeType 


**RequestTimeHistogramCopy; 
* *StallTimeHistogramCopy; 


static TimeType 
static TimeType 


*TotalRequestTimeCopy; 

*TotalStallTimeCopy; 


static ScoreType 
static ScoreType 
static ScoreType 
static ScoreType 
static ScoreType 


*NumberOfAccessesCopy; 

♦NumberOfCacheHitsCopy; 

*NumberOfBufferHitsCopy; 

*PredictedNumberOfAccessesCopy 

*PredictedNumberOfHitsCopy; 


static FILE 


*DataFileCopy; 
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★ ★ 



★ ★ 
★ ★ 
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CheckingConstants 

continued 



★ ★ 
★ * 
★ ★ 
★ * 






if (Reset) 



CacheSizeCopy 

BlockSizeCopy 

SubBlockSizeCopy 

AssociativityCopy 

WordSizeCopy 

ReadCacheAccessTimeCopy 

ReadCacheHitTimeCopy 

ReadCacheMissTimeCopy 

WriteCacheAccessTimeCopy 

WriteCacheHitTimeCopy 

WriteCacheMissTimeCopy 

MemoryAccessTimeCopy 
MemoryTransferTimeCopy 
Buf ferCacheAccessTimeCopy 

ReadBufferSizeCopy 
WriteBuf ferSizeCopy 

BlockReplacementPol icy Copy 
WritePolicyCopy 
WriteMissPolicyCopy 
ReadForwardCopy 
CPUWaitsForCacheWritesCopy 
SearchBlockBuf f erCopy 
Upda t e Re adBu f f e r C opy 
Remo veReadDup 1 i ca t e s C opy 
RemoveWriteDuplicatesCopy 

ReadPriorityCopy 

WritePriorityCopy 

ReadForWriteAllocatePriorityCopy 

WriteDirtyBlockPriorityCopy 

NoPriorityCopy 

CheckCopy 

KeyBoardlOCopy 

DataFileNameCopy 

ScreenHistogramMaxIndexCopy 

FileHistogramMaxIndexCopy 



= CacheSize; 

= BlockSize; 

= SubBlockSize; 

= Associativity; 

= WordSize; 

= ReadCacheAccessTime; 

= ReadCacheHitTime; 

= ReadCacheMissTime; 

= WriteCacheAccessTime; 

= WriteCacheHitTime; 

= WriteCacheMissTime; 

= MemoryAccessTime; 

= MemoryTransf erTime; 

= Buf ferCacheAccessTime; 

= ReadBuf ferSize; 

= WriteBuf ferSize; 

= BlockReplacementPolicy; 

= WritePolicy; 

= WriteMissPolicy; 

= ReadForward; 

= CPUWaitsForCacheWrites; 

= SearchBlockBuf fer; 

= UpdateReadBuffer; 

= RemoveReadDuplicates; 

= RemoveWriteDuplicates; 

= ReadPriority ; 

= WritePriority; 

= ReadForWriteAllocatePriority; 
= WriteDirtyBlockPriority; 

= NoPriority; 

= Check; 

= KeyBoardIO; 

= DataFileName; 

= ScreenHistogramMaxIndex; 

= FileHistogramMaxIndex; 
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Checking. c ** 

★ ★ 

Che ckingConst ants ** 

continued ** 

★ ★ 



NumberOfBlocksCopy 

NumberOfSubBlocksCopy 

NumberOfSetsCopy 

CacheBlockAddressCopy 

Las t Cach eBlockAccessTimeCopy 

CacheNextBlockCopy 

CacheValidBitCopy 

CacheDirtyBitCopy 

RequestTimeHistogramCopy 

StallTimeHistogramCopy 

TotalRequestTimeCopy 

TotalStallTimeCopy 

NumberOfAccessesCopy 
NumberOfCacheHitsCopy 
NumberOfBuf ferHitsCopy 
Predict edNumberOfAccessesCopy 
Predict edNumberOfHitsCopy 

DataFileCopy 



= NumberOfBlocks; 

= NumberOfSubBlocks; 

= NumberOfSets; 

= CacheBlockAddress; 

= LastCacheBlockAccessTime; 

= CacheNextBlock; 

= CacheValidBit; 

= CacheDirtyBit ; 

= RequestTimeHistogram; 

= StallTimeHistogram; 

= TotalRequestTime; 

= TotalStallTime; 

= NumberOfAccesses; 

= NumberOfCacheHits; 

= NumberOfBuf ferHits; 

= PredictedNumberOf Accesses; 
= PredictedNumberOfHits; 

= DataFile; 



} 






★ ★ 
★ ★ 
* ★ 
★ * 






★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 



Checking. c 

CheckingConstants 
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★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 






if ( ! (Reset) ) 



if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 
if ( 



CacheSizeCopy 

PrintConstError ( "CacheSize" ) ; 
BlockSizeCopy 

PrintConstError ("BlockSize") ; 
SubBlockSizeCopy 
PrintConstError ("SubBlockSize") ; 
AssociativityCopy 
PrintConstError ("Associativity") ; 
WordSizeCopy 

PrintConstError ("WordSize" ) ; 
ReadCacheAccessTimeCopy 



= CacheSize) 

= BlockSize) 

= SubBlockSize) 

= Associativity) 

= WordSize) 

= ReadCacheAccessTime) 



MemoryAccessTime ) 

r 

MemoryTrans f erTime ) 

'); 

Buf ferCacheAccessTime) 



PrintConstError ( "ReadCacheAccessTime " ) ; 
ReadCacheHitTimeCopy 1 = ReadCacheHitTime) 

PrintConstError ("ReadCacheHitTime" ) ; 

ReadCacheMissTimeCopy ! = ReadCacheMissTime) 

PrintConstError ("ReadCacheMissTime") ; 

WriteCacheAccessTimeCopy != WriteCacheAccessTime) 

PrintConstError ("WriteCacheAccessTime") ; 
WriteCacheHitTimeCopy 1= WriteCacheHitTime) 

PrintConstError ("WriteCacheHitTime") ; 

WriteCacheMissTimeCopy l = WriteCacheMissTime) 

PrintConstError ( "WriteCacheMissTime") ; 

MemoryAccessTimeCopy I = 

PrintConstError ("MemoryAccessTime" ) 

MemoryTransferTimeCopy ! = 

PrintConstError ( "Memo ryTransf erTime' 

Buf ferCacheAccessTimeCopy i = 

PrintConstError ("Buf ferCacheAccessTime" ) ; 

ReadBuf f erSizeCopy ! = ReadBuf ferSize) 

PrintConstError ( "ReadBuf ferSize" ) ; 

Writ eBuff erSizeCopy ! = Wr it eBuf ferSize) 

PrintConstError ("Writ eBuf ferSize") ; 

BlockReplacementPolicyCopy i = BlockReplacementPolicy) 

PrintConstError ( "BlockReplacementPolicy" ) ; 

WritePolicyCopy != WritePolicy) 

PrintConstError ( "WritePolicy" ) ; 

WriteMissPolicyCopy ! = WriteMissPolicy) 

PrintConstError ("WriteMissPolicy") ; 

ReadForwardCopy 1= ReadEorward) 

PrintConstError ( "ReadForward" ) ; 

CPUWaitsForCacheWritesCopy 1= CPUWaitsForCacheWrites) 

PrintConstError ( "CPUWaitsForCacheWrites" ) ; 

SearchBlockBuf ferCopy ! = SearchBlockBuf fer) 

PrintConstError ( "SearchBlockBuf fer" ) ; 

UpdateReadBuf ferCopy 1= UpdateReadBuf fer) 

PrintConstError ( "UpdateReadBuf fer" ) ; 
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CheckingConstants 

continued 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★-a-** 



if( RemoveReadDuplicatesCopy != RemoveReadDuplicates) 

PrintConstError ("RemoveReadDuplicates" ) ; 
if ( RemoveWriteDuplicatesCopy != RemoveWnteDuplicates ) 

PrintConstError ( "RemoveWriteDuplicates" ) ; 
if( ReadPriorityCopy != ReadPriority) 

PrintConstError ( "ReadPriority" ) ; 
if ( WntePriorityCopy 1= WritePriority ) 

PrintConstError ("WritePriority") ; 

if ( ReadForWriteAllocatePriorityCopy 1= ReadForWnteAllocatePriority) 
PrintConstError ("ReadForWriteAllocatePriority" ) ; 
if ( WriteDirtyBlockPriorityCopy 1= WriteDirtyBlockPriority ) 

PrintConstError ("WriteDirtyBlockPriority" ) ; 
if ( NoPnontyCopy 

PrintConstError ( "NoPnority " ) ; 
if ( CheckCopy 

PrintConstError ( "Check" ) ; 
if ( KeyBoardlOCopy 

PrintConstError ( "KeyBoardIO" ) ; 
if ( DataFileNameCopy 

PrintConstError ( "DataFileName " ) 
if ( ScreenHistogramMaxIndexCopy 

PrintConstError ( " ScreenHistogramMaxIndex" ) ; 
if ( FileHistogramMaxIndexCopy 1= FileHistogramMaxIndex) 

PrintConstError ( "FileHistogramMaxIndex" ) ; 



!= NoPnority) 

!= Check) 

!= KeyBoardIO) 

!= DataFileName) 

!= ScreenHistogramMaxIndex) 






/ 

* ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★ 

★ ★★★★★★ 



Checking. c 

CheckingConstants 

continued 
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★ ★ 



★ ★ 
★ ★ 
★ ★ 
★ ★ 






if( Nuir rOfBlocksCopy 1= NumberOfBlocks) 

Pri ConstError ( "NumberOfBlocks " ) ; 
if( NumterOfSubBlocksCopy 1= NumberOf SubBlocks) 

PrintConstError ( "NumberOf SubBlocks " ) ; 
if ( NumberOf Set sCopy != NumberOf Sets ) 

PrintConstError ( "NumberOf Sets" ) ; 
if ( CacheBlockAddressCopy 1 = CacheBlockAddress) 

PrintConstError ("CacheBlockAddress") ; 
if ( LastCacheBlockAccessTimeCopy 1= LastCacheBlockAccessTime) 

PrintConstError ("LastCacheBlockAccessTime" ) ; 
if ( CacheNextBlockCopy != CacheNextBlock) 

PrintConstError ("CacheNextBlock") ; 
if( CacheValidBitCopy != CacheValidBit ) 

PrintConstError ("CacheValidBit") ; 
if( CacheDirtyBitCopy 1= CacheDirtyBit ) 

PrintConstError ("CacheDirtyBit") ; 
if( RequestTimeHistogramCopy !- RequestTimeHistogram) 

PrintConstError ( "RequestTimeHistogram" ) ; 
if( StallTimeHistogramCopy 1= StallTimeHistogram) 

PrintConstError ( " StallTimeHistogram" ) ; 
if( TotalRequestTimeCopy != TotalRequestTime) 

PrintConstError ("TotalRequestTime") ; 
if( TotalStallTimeCopy 1= TotalStallTime) 

PrintConstError ( "TotalStallTime" ) ; 
if ( NumberOfAccessesCopy != NumberOf Accesses) 

PrintConstError ("NumberOf Accesses") ; 
if( NumberOfCacheHitsCopy 1= Numb erOfCacheH its) 

PrintConstError ( "NumberOfCacheHits" ) ; 
if ( NumberOfBuf ferHitsCopy != NumberOfBuf ferHits) 

PrintConstError ( "NumberOfBuf ferHitsCopy " ) ; 
if ( PredictedNumberOfAccessesCopy 1= Predict edNumberOf Accesses) 
PrintConstError ("Predict edNumberOf Accesses" ) ; 
if ( PredictedNumberOfHitsCopy 1= PredictedNumberOfHits) 

PrintConstError ("PredictedNumberOfHits") ; 
if( DataFileCopy != DataFile) 

PrintConstError ("Datafile") ; 

} 



} 
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★ 

★ ★ 



PrintConstError ** 

r ★ ★ 



)id PrintConstError (VanableName) 

i 

char *VariableName; 



{ 

printf (”\n\nError in [CheckingConstants] " ) ; 

printf(" \n%s did not remain constant . \n", VariableName) ; 

exit (0) ; 

} 



★ * 



/★★★★★★★★★★★★★★★★★★★**★*****************************■*************************★ 
** Page 13-12 ** 

** Checking. c ** 

★ ★ ** 

*+ CheckingForValuesOutOfBounds ** 

★ ★ 

★ ★ 

★ ★ ★★ 

** CheckingForValuesOutOfBounds checks all bounded global variables ** 

** to see if they fall within their prescribed boundaries. ** 

★ ★ ★ * 



** Description: 



void CheckingForValuesOutOfBounds () 



{ 

TimeType MaxTime =10000000001; 
ScoreType MaxScore=10000000001; 



SizeType 

SizeType 

SizeType 

RequestType 

CacheWaitingForType 



Blocklndex; 
SubBlocklndex; 
Set Index; 
Requestlndex; 
Stalllndex; 



if (Time<0 

| | Time>MaxTime) 

Pr intTimeBoundaryErr or ("Time" , Time , 01, MaxTime) ; 

if ( CacheWaitingFor<Nothing 

| | CacheWaitingFor>NumberOfCacheWaitingForsAvailable) 
PrintEnumBoundaryError ( n CacheWait ingFor ,f , CacheWaitingFor, 

Nothing, NumberOfCacheWaitingForsAvailable) ; 

if ( MemoryWaitingFor<NothingTwo 

I | MemoryWaitingFor>NumberOfMemoryWaitingForsAvailable) 
PrintEnumBoundaryError ( ,, MemoryWaitingFor M , MemoryWaitingFor, 

NothingTwo, NumberOfMemoryWaitingForsAvailable) ; 

if ( BlockWaitingFor<NothingThree 

| | BlockWaitingFor>NumberOfBlockWaitingFors Available) 
PrintEnumBoundaryError ( n BlockWaitingFor n , BlockWaitmgFor, 

NothingThree, NumberOfBlockWaitingForsAvailable ) ; 

if ( CacheHit<No 

I | CacheHit>Unknown) 

PrintEnumBoundaryError ( n CacheHit , CacheHit, No, Unknown) ; 

if ( CacheBusy<No 
I | CacheBusy>Yes) 

PrintEnumBoundaryError ( "CacheBusy” , CacheBusy, No, Yes) ; 
if ( Request<None 

I | Request>NumberOfRequestsAvailable) 

PrintEnumBoundaryError (’’Request” , Request, 

None, NumberOfRequestsAvailable) ; 

if ( LastRequest<None 

I I LastRequest >NumberOfRequestsAvailable ) 

PrintEnumBoundaryError (’’LastRequest ”, Request, 

None, NumberOfRequestsAvailable) ; 
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★ ★ 



★ ★ 



CheckingForValuesOutOfBounds * * 

continued ** 

★ ★ 



if ( RequestSize<0 

| | RequestSize>BlockSize) 

Print SizeBoundaryError ( "Request Size” , Request Size, 0, BlockSize) ; 



if ( RequestBlockNumber<0 

| | RequestBlockNumber>=NumberOf Blocks) 

{ 

Print SizeBoundaryError ( " Request BlockNumber " , RequestBlockNumber, 

0, NumberOfBlocks) ; 



> 



if ( TimeOfNextRequest<0 

I | TimeOfNextRequest>MaxTime) 

Print TimeBoundaryError ( " TimeOfNextRequest " , TimeOf NextRequest , 

01, MaxTime) ; 

for (SetIndex=0; Set Index<NumberOf Sets ; Setlndex++) 
if ( CacheNextBlock [Set Index] <0 

I | CacheNextBlock [Setlndex] >=NumberOf Blocks) 

Print SizeBoundaryError ("CacheNextBlock", CacheNextBlock [Setlndex] , 

0,NumberOfBlocks) ; 



for (BlockIndex=0; BlockIndex<NumberOf Blocks; BlockIndex++) 

{ 

for (SubBlockIndex=0; SubBlockIndex<NumberOf SubBlocks; SubBlockIndex++) 

{ 

if ( CacheValidBit [Blocklndex] [SubBlocklndex] <0 
I | CacheValidBit [Blocklndex] [SubBlocklndex] >1) 
PrintEnumBoundaryError ( "CacheValidBit", 

CacheValidBit [Blocklndex] [SubBlocklndex] , 

0 , 1 ); 

if ( CacheDirtyBit [Blocklndex] [SubBlocklndex] <0 
I | CacheDirtyBit [Blocklndex] [ SubBlocklndex] >1) 
PrintEnumBoundaryError ( " CacheDirtyBit " , 

CacheDirtyBit [Blocklndex] [SubBlocklndex] , 

0 , 1 ); 

} 

} 



for (Request lndex=0 ; Request Index<NumberOfRequest sAvailable ; Request Index++) 
if ( TotalRequestTime [Request Index] <0 

| | TotalRequestTime [Request Index] >Time) 

PrintTimeBoundaryError ( "TotalRequestTime", 

TotalRequestTime [Request Index] , 

01, Time) ; 



/★★★★*★★★★★★★★*★★**★★★★★★★★**★★★**********************★★*★★★**★★★★*★★★★★★★★*★★ 
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** Checking. c ** 

★ ★ ★★ 



** CheckingForValuesOutOfBounds ** 
** continued ** 
★ ★ ★ ★ 



for (StallIndex=0; 

Stall Index<NumberOf CacheWaitingForsAvailable; 
Stalllndex++) 

if ( TotalStallTime [Stalllndex] <0 

I | TotalStallTime [Stalllndex] >Time) 
PrintTimeBoundaryError ( "TotalStallTime", 

TotalStallTime [Stalllndex] , 
01, Time) ; 



if ( TotalNumberOfAccesses<0 

I | TotalNumberOfAccesses>MaxScore) 

Print ScoreBoundaryError ( "Tot alNumberOf Accesses " , TotalNumberOf Accesses, 

01, MaxScore) ; 



if ( TOA<0 

I | TOA>MaxTime) 

PrintTimeBoundaryError ("TOA", TOA, 01, MaxTime); 

if ( TOD<0 

I | TOD>MaxTime) 

PrintTimeBoundaryError ("TOD", TOD, 01, MaxTime); 



} 
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Print TimeBoundaryError 



★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■a-* 



/ 



■id PrintTimeBoundaryError (VariableName, Value, LowLimit, HighLimit) 

char *VariableName ; 

TimeType Value; 

TimeType LowLimit; 

TimeType HighLimit; 

{ 

printf ( M \n\nError found in [CheckingForValuestOutOfBounds ] " ) ; 
printf (" \n%s is out of prescribed bounds VariableName) ; 



printf ( M \n\n The value was "); 

Print Time (Value) ; 

printf (" \n The low limit was ,f ); 

Pr int Time (LowLimit ) ; 

printf ( ,f \n The high limit was "); 

PrintTime (HighLimit) ; 



printf (" \n\n rf ) ; 
DiscrepancyFound=Yes; 



} 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★♦♦★★★♦★♦★♦★★★★★★★★★★★★★★★★★★★★★★★★★•a-* 
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** Checking. c ** 

★ ★ ★ ★ 

** PrintScoreBoundaryError ** 

★ ★ ★ ★ 



void PrintScoreBoundaryError (VariableName, Value, LowLimit, HighLimit) 

char * VariableName ; 

ScoreType Value; 

ScoreType LowLimit ; 

ScoreType HighLimit; 

{ 

print f ("\n\nError found in [ CheckingForValuestOutOf Bounds ]") ; 
pnntf(” \n%s is out of prescribed bounds VariableName) ; 



printf( n \n\n The value was " ); 

PrintScoreCentered (Value) ; 

print f(” \n The low limit was " ); 

PrintScoreCentered (LowLimit ) ; 

printf(” \n The high limit was "); 

PrintScoreCentered (HighLimit ) ; 



print f ("\n\n"); 
DiscrepancyFound=Yes; 



} 
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* * 

r ★ ★ 

>id PrintSizeBoundaryError (VariableName, Value, LowLimit, HighLimit) 

char *Var iableName ; 

SizeType Value; 

SizeType LowLimit; 

SizeType HighLimit; 



{ 



print f ("\n\nError found in [ Checking! orValuestOutOf Bounds ]") ; 
printf(" \n%s is out of prescribed bounds VariableName) ; 



printf ("\n\n The value was "); 

PrintSize (Value) ; 

printf (" \n The low limit was "); 

PrintSize (LowLimit) ; 

printf (" \n The high limit was "); 

PrintSize (HighLimit) ; 



printf (" \n\n" ) ; 
DiscrepancyFound=Yes; 
} 



/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A-** 

** Page 13-18 ** 
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★ ★ ★ ★ 

*+ PrintEnumBoundaryError ** 
* * ★ ★ 
★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•'A'****** j 



void PrintEnumBoundaryError (VariableName, Value, LowLimit, HighLimit) 

char *VariableName; 
int Value; 
int LowLimit; 
int HighLimit; 

{ 

print f (”\n\nError found in [CheckingForValuestOutOfBounds ] " ) ; 
printf(” \n%s is out of prescribed bounds. ”, VariableName) ; 



printf( ,f \n\n The value was "); 

print f (” %d" , Value) ; 

printf( n \n The low limit was ”); 

print f ("%d", LowLimit) ; 

printf( ,f \n The high limit was "); 

print f (” %d” , HighLimit) ; 



printf (”\n\n ,f ) ; 
DiscrepancyFound=Yes ; 



} 



Checking. c 



CheckingFor Inconsistencies () 



')id CheckingForlnconsistencies () 

•* { 

CacheWaitingForType CacheWaitingForlndex; 

Request Type Request Index; 

TimeType TotalTime; 

ScoreType SumO f Accesses; 

HistogramlndexType Histogramlndex; 

ScoreType PredictedNumberOf WordsReadFromMemory ; 

TotalTime=0; 

for (CacheWaitingForIndex=Nothing; 

CacheWaitingForIndex<NumberOfCacheWaitingForsAvailable; 

CacheWaitingForIndex++) 

TotalTime+=TotalStallTime [CacheWaitingForlndex] ; 
if (TotalTime 1 =Time) 

PrintTotalTimeError (Time, TotalTime, "Stalls") ; 
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★ ★ 
★ ★ 
★ ★ 
★ ★ 



Checking. c 

CheckingForlnconsistencies () 



★ ★ 
★ ★ 
★ * 
★ ★ 






TotalTime=0; 

for (RequestIndex=Nothing; 

Request Index<NumberOf Request sAvailable; 
Request Index++) 

TotalTime+=TotalRequestTime [Request Index] ; 



if (TotalTime ! =Time) 

PrintTotalTimeError (Time, TotalTime, "Requests") ; 

for (Request Index=Read; 

Request Index<NumberO f Request sAvailable; 

Request Index++) 

{ 

SumOfAccesses = 0/ 

for (HistogramIndex=0; 

His togramIndex<F ileHistogramMax Index; 

HistogramIndex++) 

SumOfAccesses+=RequestTimeHistogram(RequestIndex] [Histogramlndex] ; 

if (SumOfAccesses ! =NumberOfAccesses [Request Index] ) 

PrintTotalScoreError (NumberOfAccesses [Request Index] , 

SumOfAccesses, 

Requeststring [Request Index] ) ; 



if (CacheWaitingFor==Nothing && ReadBuf fer .Empty==Yes && 

UpdateReadBuf fer==No && SearchBlockBuf fer==No && 

RemoveReadDuplicates==Yes && WriteMissPolicy==WriteAround ) 

{ 

Predict edNumberOfWordsReadFromMemory= 

(NumberOfAccesses [Read] 

-NumberOfCacheHits [Read] 

-NumberOfBuf ferHits [Read] ) *BlockSize/WordSize; 
if (PredictedNumberOfWordsReadFromMemory 1 = 
TotalNumberOfWordsReadFromMemory) 

PrintTotalScoreError (Predict edNumberOfWordsReadFromMemory, 

TotalNumberOfWordsReadFromMemory, 
"Read Misses"); 

} 



} 
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Print TotalTimeError 






nd PrintTotalTimeError (TimeValue, TotalTimeValue, VariableName) 

TimeType TimeValue; 

TimeType TotalTimeValue; 
char *VariableName; 

{ 

printf ("\n\nError found in [CheckingForlnconsistencies] the total sum"); 
printfC \nof %s times does not equal the actual time.", VariableName); 

printf ("\n\n Total time was equal to ... "); 

PrintTime (TimeValue) ; 

printfC \n The sumation of %s", VariableName); 

printfC \n times was "); 

PrintTime (TotalTimeValue) ; 

printf ("\n\n") ; 

DiscrepancyFound=Yes ; 

) 



** Page 13-22 ** 
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★ ★ * ★ 

** PrintTotalScoreError ** 
★ * * ★ 
★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A-*** i 



void PrintTotalScoreError (TotalScoreValue, SumScoreValue, VariableName) 

ScoreType TotalScoreValue; 

ScoreType SumScoreValue; 
char *Var iableName ; 

{ 

printf ("\n\nError found in [CheckingForlnconsistencies] the total for"); 
pnntf (" \n%s does not equal the summation.", VariableName); 

printf (”\n\n Total number of %s accesses", VariableName); 

printf (" \n was equal to "); 

PrintScoreCentered (TotalScoreValue) ; 

printf (" \n The sumation of %s request histogram", VariableName); 

printf (" \n was equal to "); 

PrintScoreCentered (SumScoreValue) ; 

printf ("\n\n") ; 

DiscrepancyFound^Yes; 



} 
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CheckingP redictions 



★ ★ 
★ ★ 
★ ★ 






ad CheckingPredictions ( ) 

{ 



if (PredictedNumberOf Accesses [Read] l =NumberOfAccesses [Read] ) 

PrintScorePredictionError (PredictedNumberOfAccesses [Read] , 

NumberOfAccesses [Read] , 

"Read Accesses"); 

if (PredictedNumberOfAccesses [Write] !=NumberOf Accesses [Write] ) 

PrintScorePredictionError (PredictedNumberOfAccesses [Write] , 

NumberOfAccesses [Write] , 

"Write Accesses"); 

if (DiscrepancyFound==No) 

{ 

if (PredictedNumberOfHits [Read] 1= NumberOf CacheHits [Read] 

+ NumberOfBuf ferHits [Read] && 
BlockReplacementPolicy==LRU && 

SearchBlockBuf fer==Yes && RemoveReadDuplicates==Yes) 

PrintScorePredictionError (PredictedNumberOfHits [Read] , 

NumberOfCacheHits [Read] 

+NumberOfBuf ferHits [Read] , 

"Read Hits"); 

if (PredictedNumberOfHits [Write] 1= NumberOfCacheHits [Write] 

+ NumberOfBuf ferHits [Write] && 

BlockReplacementPolicy==LRU && Wr it eMis sPo 1 icy==Wr it eAl locate && 
WritePolicy==WnteThrough) 

PrintScorePredictionError (PredictedNumberOfHits [Write] , 

NumberOfCacheHits [Write] 

+NumberOfBuf ferHits [Write] , 

"Write Hits"); 



} 



} 






★ ★ 
★ ★ 
★ ★ 
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★ ★ 
★ ★ 
★ ★ 
★ ★ 






void PrintScorePredictionError (PredictedValue, ActualValue, VariableName) 

ScoreType PredictedValue; 

ScoreType ActualValue; 
char * VariableName; 

{ 

printf ("\n\nError found in [CheckingPredictions ] when trying to predict %s”, 
VariableName) ; 

printf ("\n\n The predicted value was ... " ); 

PrintScoreCentered (PredictedValue) ; 

printf (" \n The actual value was " ); 

PrintScoreCentered (ActualValue) ; 

printf (" \n\n" ) ; 

DiscrepancyFound=Yes; 

} 
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PrintTimePredictionError 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•a-*** 



id PrintTimePredictionError (PredictedValue, 

ActualValue, 

RequestName, 

ProcedureName) 

TimeType PredictedValue; 

TimeType ActualValue; 
char *RequestName; 

char *ProcedureName ; 

{ 

printf ("\n\nError found in [%s] when trying to predict time to complete 
ProcedureName, RequestName) ; 

printf ("\n\n The predicted value was ... "); 

PrintScoreCentered (PredictedValue) ; 

printf (" \n The actual value was "); 

PrintScoreCentered (ActualValue) ; 

printf ("\n\n") ; 

DiscrepancyFound=Yes ; 
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